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WELCOME TO 
THE OFFICIAL 
MAGAZINE 


he holiday season is upon us and that 
can mean lots of different things for 
lots of different people. For me it 
means spending some quality time with my 
family and keeping my kids entertained with 
games and fun projects. We’ve done our best 
to come up with some project ideas in our 
Christmas issue, including a great way to turn 
our Christmas tree cover into a blinky light SEE PAGE 28 FOR DETAILS 
sensation. Grab some LEDs, a pair of scissors, 
and turn to page 14 to get started. 


If you’re new to electronics, we’ve got 
you covered in our Raspberry Pi 101 tutorials THIS MONTH: 


starting on page 4Oo. It’s easier (and much 
14 MERRY CHRISTMAS MAKES 


more fun) than you might think. 
Add some shiny blinking lights to this month's cover! 


SUBSCRIBE & 


If you’re a bit old-school like me, you might 
be interested in reliving the glory days of the 


Amiga. Check out our expert guide starting AO GET STARTED WITH CIRCUITS 


on page 58 to learn how to emulate one of the 
Top-notch beginner advice for breadboards and GPIO Zero 
ereatest computers ever made on one of the 


greatest computers ever made! 58 RELIVE THE GLORY DAYS 


Enjoy the issue. Emulate the Amiga, one of greatest computers ever made 


Russell Barnes 68 GIVE YOUR ROBOT BRAINS 


Managing Editor Build on last month's amazing robot to add sensors and smarts 
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News 


THE PIONEERS 


New Raspberry Pi programme for teens needs mentors and clubs to help out 


Above A series 
of competitions 
will inspire 
young makers to 
turn their ideas 
into reality 
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needs your help to keep 


with code and technology. 

The Pioneers project is going to 
be a new programme for coding 
clubs and teen makers. It will 
launch in the new year, and it will 
need both enthusiastic teens and 
adult volunteers. 


JOIN PIONEERS 


The Pioneers challenge is 
open to everyone in the UK 
between the ages of 12 and 15. 
It's for teams of four or under. 
The Raspberry Pi Foundation 
asks that each team finds 
someone over the age of 18 to 
act as a mentor. 
raspberrypi.org/pioneers 
#MakeYourldea 
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he Raspberry Pi Foundation 


teenagers making cool stuff 


#MAKEYOURIDEAS 


Teenagers in the UK can become 
Pioneers by signing up online at 
raspberrypi.org/pioneers. The 
hashtag #MakeYourldeas will be 
used to share projects. 

“We want to find and support 
teenage digital makers in the 
UK,” says Rob Buckland, director 
of programmes. “All over the 
world, teenagers are building cool 
stuff, learning how to bend digital 
technology to solve problems they 
care about, and having lots of fun.” 

More importantly, says Rob, 
“they are the next generation of 
inventors, entrepreneurs, and 
makers. We want to support 
them. The aim of Pioneers is to 
provide guidance, inspiration, and 
mentorship to teenage makers, and 
to the adults who mentor them.” 

Every school term, Raspberry 
Pi will set a new mission for 
the Pioneers community. Each 
of these challenges will have a 
different theme. 

“They will win cool swag and 
money-can’t-buy experiences,” 
Rob reveals. 

For young makers “it’s also a 
chance to work with a team of like- 
minded people to create an idea 


they love,” says Rob. “Something 
that is relevant to them. 

“Importantly, it’s alsoa 
chance for teenagers to show 
the Raspberry Pi Foundation and 
maker community what they can 
do,” he explains. 

So teenage Pioneers get to win 
both prizes and kudos. It sounds like 
a great idea to us. 

The first Pioneers competition 
will launch in January 2017. The 
first challenge will be announced 
early next year, and we can’t wait to 
hear what it is. 


New recruits 

Pioneers will be aged between 12 and 
15. “Get together with some buddies 

and form a team,” suggests Rob. Up 

to four Pioneers can be in a team. 

“There is no right or wrong 
way to start a Pioneers team,” 
says Olympia Brown, the senior 
programme manager who will be 
running the Pioneers scheme. “It 
can be motivated by students or 
inspired by a mentor.” 

There is one condition, according 
to Olympia: “We just ask that each 
team finds someone over the age of 
18 to act as a mentor.” 

Pioneers will start their first 
mission in January 2017. “Each team 
has to produce a video of their work 
to show the judges and the rest of 
the world,” says Olympia. 

Projects will be judged, and the 
best ones will win prizes. “We all 
like to be winners,” says Rob, “but 
it’s a great chance to get together 
with like-minded, creative souls 
and start anew community... 
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Mentors can be any responsible 
adult who wishes to guide 
teenagers on the project. 

They may run a makerspace 


or CoderDojo, or be a school 
teacher, scout leader, or parent. 
There is no right or wrong way 
to build a team. Taking part can 
be motivated by students or 
inspired by a mentor. 
raspberrypi.org/pioneers 


A community where we share 
skills, make our ideas a reality, 
occasionally blow things up, and 
lead the way for the future in an 
increasingly digital world.” 


Mentoring 

Pioneers will need guidance and 
help, and as such the Raspberry 

Pi Foundation is looking for adult 
mentors to provide this. “It’s a 
chance to help young people on 
their journey to expand their digital 


making skills,” comments Olympia. 


The Raspberry Pi Foundation 
hopes that mentors will come in 
all shapes and sizes. They could 
be already involved with the 
Raspberry Pi community. “We 
expect mentors to be running a 
CoderDojo, a makerspace, ora 
similar club,” says Rob. 

“We designed Pioneers so that 
existing computing clubs and 
CoderDojos can get involved,” 
explains Philip Colligan, CEO of 
Raspberry Pi. “It’s also a great 
excuse to get together for the first 
time and we’re hoping that we 
will see many more young people 
getting creative with technology.” 

Pioneers will also provide 
a much-needed next step for 


Pioneers will challenge teenagers 
to create amazing things with technology 
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teenagers who have outgrown Code 
Club. While Code Club is designed to 
introduce young makers to coding, 
Pioneers will enable teens to show 
what they can create. 

“Pioneers will provide an 
exciting follow-on activity for 
children coming from Code Club 
to continue to develop their 
coding skills and be creative,” 
States Maria Quevedo, director 
of Code Club UK. “Tt will be a 
ereat opportunity for them to 
continue making things with 
computers and to show off their 
work to others.” 

Giustina Mizzoni, executive 
director at CoderDojo, agrees. 
“There is so much creativity and 
talent in the community,” she 
tells us. “One place where it is 
evident is in our annual Coolest 
Projects Awards. I was inspired by 
SO Many unique and interesting 
projects... Orla, 16, designed a 
mobile app Key Tracker, using 
Bluetooth, while Carl and Leo 
(both 14) built a Braille label 
puncher that converted text to 
Braille and printed it on thin 
aluminium plates.” 

“The Raspberry Pi Foundation is 
focused on putting digital making 
into the hands of everyone, and 
we are passionate about making 
sure there is provision for all 
ages,” asserts Rob. “That’s where 
Pioneers comes in.” 

“We’re really excited to launch 
Pioneers,” says Philip. “There’s 
already an amazing community of 
young digital makers out there. 
We want to celebrate what they’re 
achieving and challenge them to 
do even more.” 


Flood Gauge 
Shane Fahy was just 
11 when he started 
CoderDojo Athenry in 
2013. He received his 
Future Makers Award 
in the RDS Dublin on 
18 June 2016 for his 
flood detector project. 
“Don't think of itasa 
competition — do it 
because you enjoy it,” 
advises Shane. 
magpi.cc/2g2KwLZ 


Student Essentials 
Jack Underwood, 12, 
won the Innovation 
Award from Benchmark 
Recruitment for his app, 
Student Essentials. The 
app helps students 

in the classroom and 
includes a Homework 
Tracker, Measurement 
Converter, Translator, 
Notepad, QR Code 
Scanner, and more. 
magpi.cc/2g2O0iF8 


Sign Language Translator 
Ryan Patterson was 17 when he built this Sign 


Language Translator. It was a Grand Award winner in 
the Intel International Science and Engineering Fair. 


The glove detects hand movements used in ASL and 


translates them into letters. 
magpi.cc/2g2NiRD 
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PI FINANCE 


ank Underground, the leading models are given 
Bank of England’s blog, away free via easily accessible 
reports that Raspberry working papers.” 
Pi computers are being used To show you just far we’ve 
to test out macroeconomic come, Andrew built a modern 
modelling systems. macroeconomic model using the 
“There was a time when macro- COMPASS economic model. This 
modelling was an expensive was built and tested to provide 
business,” says Andrew Blake, economic forecasting on a 


senior advisor in monetary analysis Raspberry Pi Zero computer. 


There are no barriers to entering 
the macro-modelling world left 


at the Centre for Central Banking “There are no barriers to 
Studies. “You needed economic entering the macro-modelling 
theorists, at least a couple of tame world left,” concludes Andrew. 
econometricians, someone who “Not even the cost of the 
could actually program, research computer. You don’t have to run 
assistants to delve into the long- it on a Raspberry Pi, but if you do, 
abandoned stacks of library it is remarkably straightforward, 
basements to source data, and ridiculously entertaining, and 
alchemists well-versed inthe dark — properly educational.” 
arts of forecasting and simulation. Full details of the project can be 
mit Sete tic nasceah Bi comer “Nowadays: not so much,” he found on the Bank Underground 
tells us. “Many of the world’s blog (magpi.cc/2fHsL2q). 
IT engineers are using “When one of these chemicals is 
Raspberry Pi boards present in the groundwater, which 
and spinach plants to is sampled naturally by the plant, 
detect explosives. carbon nanotubes embedded in 
The remarkable new technology the plant leaves emit a fluorescent 
is called ‘plant nanobionics’. signal that can be read with an 
Spinach plants are injected with — infrared camera.” 
carbon nanotubes, and the leaves “This is a novel demonstration of 
are then scanned bya Raspberry Pi how we have overcome the plant/ 
and infrared camera. human communication barrier,” 
“The plants were designed says Michael Strano, the Carbon 
to detect chemical compounds P. Dubbs professor of chemical 
known as nitroaromatics, which engineering at MIT. 
are often used in landmines and A video of the remarkable project 
other explosives,” says Anne can be watched online at MIT eet) plantnesPen nie cecu Unearbep 


nanotubes that respond to nitroaromatic compounds 


Trafton from the MIT News Office. (magpi.cc/2fHxFfC). 
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A CUSTOM GIFT 


WD PiDRIVE 
FOUNDATION 
EDITION 


Combining SD card and USB drive functionality, the 
WD PiDrive Foundation Edition is preloaded with 
custom software to help you start creating 
Raspberry Pi projects quickly and easily. 


S 


WD PIDRIVE FOUNDATION EDITION WD PIDRIVE FOUNDATION EDITION WD PIDRIVE FOUNDATION EDITION 
USB HARD DRIVE 250GB USB HARD DRIVE 375GB 
$28.99 $37.49 
USB Flash Drive USB 2.5" 7mm HDD USB 2.5" 7mm HDD 
SanDisk MicroSD™ card SanDisk MicroSD™ card SanDisk MicroSD™ card 
WD PiDrive Cable WD PiDrive Cable 


© WDLABS vent wdlabs.wd.com/holiday 


The 
Computer Aid 
Connect brings 
offline internet 
access to remote 
parts of the world 


omputer Aid brings access 

to digital technology 

to some of the world’s 
poorest people. The charity’s latest 
project uses recycled Raspberry Pis 
to provide offline classrooms with 
a wealth of educational resources. 

Computer Aid Connect is a 

portable hotspot device based on 
the Raspberry Pi. “It is for offline 


students, and teachers, across 
the world,” says Nicola Gampell, 
e-learning and marketing officer 
for Computer Aid International. 
Based on the RACHEL-Pi 
(magpi.cc/2fUKzua), Connect will 
“bring them a local internet full of 
educational resources ranging from 
scientific simulations to Wikipedia 
articles,” Nicola tells us. 


SSIES 
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With Computer Aid Connect kids will be able to 
access educational sites even without a connection 
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COMPUTER 


“All too often we’re reminded 
of this reality,” writes Jeremy 
Schwartz, executive director of 
World Possible, which created 
RACHEL. “There are places where 
young people aren’t given the 
resources they need to learn. For 
many, the internet has become a 
small equalising force, but for many 
more, that equaliser does not exist. 

“In 2017, we’re going to test 
RACHEL against as many different 
use cases aS we can,” continues 
Jeremy. “We’ll be formalising our 
own testing through our social 
entrepreneurs, and intimately 
supporting a narrower group of 
other organisations”. 

“We currently have 20 [devices] 
about to arrive to a project in 
Ethiopia and one in Mauritania,” 
says Nicola. “So hopefully we’1l be 
getting to see it in action soon. 

“The Raspberry Pi is a key 
component of the device, being 
beneficial to for its low power 
usage and low cost. 

“Tt also uses the UPS Plco 
Uninterruptible Power Supply to 
make it sustainable and stable 
during power outages.” 

Inside each Computer Aid 
Connect is a64GB SD card anda 
wireless N150 high-power USB 
adapter (magpi.cc/2fUW58N). 

“The version of the Raspberry Pi 
used changes between the Pi 2 and 
the old Model A,” explains Nicola, 
“as we receive donations of old 
Raspberry Pi devices.” 

You can donate to Computer Aid, 
or request devices, on the charity’s 
website (magpi.cc/2fURnIo). 
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version of SUSE Linux 

Enterprise Server (SLES) 

has been released for 
Raspberry P1. 

SUSE is lised byrne Plnopeam 
Space Agency to handle Mission 
Control and by thie keibmniz 
SUpercOmplTiNne Centre te 
control SuperMUC, the fastest 
Supercomputer in Europe. 

In October, SUSE announced that 
it had optimised SLES for ARM- 
based 64-bit servers. 

SUSE Linux Enterprise Server 
for ARM will give customers 
more choice, flexibility, and 
opportunities,” says Ralf Flaxa, 
SUSE president of engineering. 
“And they will be able to do it 
faster than ever before.” 


BRAN 


he second edition of The 

MagPi Educator’s Edition 

is now available. This 
special edition of The MagPi is 
created for teachers and educators 
interested in Raspberry Pi and 
computer science. 

“At the heart of Raspberry 

Piis a global community of 
educators who are working both 


RESOURCES FOR THE CLASSROOM 
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“We decided to bring SUSE 
Ln Ubs EMMI DIN S Seine 0) are 
Rasp Denin Pi Lommehease thie 
A Seulney: Wose SUISIB, allavel SILIES 
comments Jay Kruemcke, senior 
product manager at SUSE. “But to 
be honest, we also did it because it 
looked like fun. 

~The real breakthrough for us in 
this process was the enthusiastic 
support that we received from 
Eben Upton when we told him 
of our plans,” Jay tells us. 


The latest edition of The MagPi 
translated into German - by our 
friends at CHIP — is now available. 
Our German readers are loving 
this over on Facebook. Raspberry 
Pi Trading CEO Eben Upton says, 
“Germany is our third largest 
market, so it seems natural that 
Germany should be the first 


rate nen Pye 
Portable Action-Cam mvt cern 
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country to get a localised version.” ° 


SUSE Linux ¥ = 
Enterprise 
Server is 

used to run 
mission-critical 
software 
around 

the world 
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inside and outside the classroom 
to inspire kids to get creative 
with technology,” writes Philip 
Colligan, CEO, Raspberry Pi 
Foundation. “Our job is to provide 
that community with the support 
that they need. 

“One of the ways we do that,” 
explains Philip, “is by developing 
high-quality teaching resources 
and projects, many of which don’t 
require a Raspberry Pi computer, 
all of which have been designed 
by educators, and all of which are 
available for free.” 

The MagPi Educator’s Edition is 
freely licensed under Creative 
Commons and can be downloaded 
for free (magpi.cc/2fVOPLB). 


magpi.cc/2eJOQRZ 


Our Google Plus crowd liked the look of this arcade 
joystick control kit. 


magpi.cc/2eJMqMv 


Over on Twitter, people got very excited at this project, 
by Nova Spirit, to turn a Pi Zero into a stick PC. Very few 
components are required for this ‘PC in your pocket’. 


The MagPi Educator's Edition is a special 
edition designed for teachers and educators 
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Snappy 
Ubuntu Core 
16 now on the 
Raspberry Pi 


buntu Core 16, also known 
U as ‘Snappy Ubuntu Core’, 
has been released for the 
Raspberry Pi. 
The latest version of 
Snappy Ubuntu Core has a 
completely upgraded software 
packaging system. 
“Tn Ubuntu Core 16 we Keep all 
of the software as compressed 


and signed files,” Mark 
Shuttleworth, Canonical CEO told 
The Inquirer (magpi.cc/2fUTMCK). 

“Hackers can’t modify that 
software on the disk, and the 
software on the device can always 
be validated,” explained Mark. 

On Ubuntu Core 15 the 
individual files were spread out 
over the disk, but in Core 16 
they are concentrated into a 
single blob. Snap updates are 
transactional, which means 
that failures are automatically 
rolled back, giving developers 
the confidence to update their 
applications regularly. 

The files exist as immutable 
squashFS blobs on disk. This 
means that a Raspberry Pi 
running Ubuntu Snappy Core 


ASTRO PI WINS 


ARTHUR CLARKE AWARD 


Prestigious prize awarded to programme manager, Dave Honess 


Below Winners 
of the Sir Arthur 
Clarke Awards at 
the Royal Society 
in London 


he Sir Arthur Clarke Award 

for Space Achievement 

has been awarded to Dave 
Honess, programme manager for 
Astro Pi. The British Interplanetary 
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Society (BIS) presented the award 
at a glittering reception, held at 

the Reinventing Space Conference 
Gala Dinner at the Royal Society 

in London. Dave received the Award 
for Space Achievement — Industry/ 
Project Individual. 

“Tt’s a great honour to receive 
this award,” said Dave. “I was 
rather surprised because the 
other nominees had all achieved 
so much... Astro Pi has had an 
impact on our whole organisation 
and because my name is on the 


Latest version of 
Ubuntu’s Snappy 
software introduces a 
raft of new features 


can store different versions of 
each file used in the system. 

Files can be automatically 
updated, choosing the best fit 

for the system. Updates are 
automatically rolled back if things 
don’t go to plan. 

“The snap mechanism really 
changes the game,” said Mark. 
“Your lawnmower will update 
itself every day, your MRI device 
in a hospital can be presented 
with updates offline, cars and 
robots can update themselves 
in a very reliable fashion, but 
they can also get new software 
installed on them that gives them 
new capabilities,” 

You can download the Snappy 
Ubuntu Core 16 ISO on Ubuntu’s 
website (magpi.cc/2fV43Pn). 


trophy, I would like to pay tribute 
to all of my colleagues at Raspberry 
Pi who helped make it all happen. 
That’s basically everyone! We 
couldn’t have done it without the 
UK Space Agency, ESA, and a whole 
host of aerospace companies that 
gave us free lab time to qualify the 
payload for space.” 

“It’s been great to work with 
Tim Peake, who’s been hugely 
supportive from the start,” Dave 
told us afterwards, “and while his 
flight is over, we’re looking forward 
to the upcoming flight of French 
ESA astronaut Thomas Pesquet who 
will be expanding participation in 
Astro Pi to all ESA member states. 
My hope for the future is that 
Tim will fly again and, you never 
know, we might build him a new 
educational payload of some kind.” 
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Keep an eye out for traffic wardens with this intelligent detector 


ike the rest of us, John 

Naulty, a dev ops engineer 

at Nuage Networks, hates 
getting parking tickets. But while 
most people just grumble, John 
actually built a machine-learning 
Raspberry Pi device that saves him 
from getting fined. 

Known as Metermaid Monitor, 
the device is a speed camera that 
photographs passing cars and 
detects traffic wardens (known as 
‘meter maids’ in the US). 

“Have you recently moved into 
a neighbourhood and are afraid 
to bring your car for fear of the 


oppressive meter maid°” asks John. 


“T feel your pain.” 

You can only park for two 
hours in San Francisco — arule 
that’s enforced by meter maids 
driving around in highly visible 


three-wheeled vehicles called 
‘Interceptors’. Meter maids note 
parked cars and come back every 
two hours. If the car is still around, 
they issue a fine. 

Metermaid Monitor uses 
TensorFlow (magpi.cc/2fZKtkl), 
an open-source software library 
for machine intelligence, to spot 
the distinctive Interceptors. The 
TensorFlow instance was trained 
with images of Interceptors 
which were obtained using Google 
Image Search. 

Car Speed Detector by Greg Barbu 
(magpi.cc/2fZFMXA) is used to 
detect and photograph vehicles 
driving past John’s car. A Raspberry 
Pi with a Camera Module is used to 
run all the software. 

“The purpose of this project 
was to provide a lazy way to avoid 


paying parking tickets,” 
“People who park in residential 
areas desire to park for as long as 
possible without having to move 
every two hours.” 

You can watch John Naulty 
explain his Metermaid Monitor 
at the Disrupt SF Hackathon 2016 
(magpi.cc/2fAQ9Qy6). 


says John, 


METERMAID MONITOR 


John Naulty 
explained how the 
Metermaid Monitor 
system works at 
the Disrupt SF 
Hackathon 
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MANAGED CYBER-PROTECTION SERVICE 
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SHIELD FROM EXPLOITS 
Attackers working from 
outside your system 


PROTECT FROM PHISHING 
Invitations to reveal your 
private information 


BLOCK MALWARE 
Attackers that have been 
installed inside your system 
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“sand even the food. Putting up the decorations 


» e love Christmas here at The MagPi. The food, 
| the atmosphere, the food, the decorations, 


for Christmas is a time-honoured tradition, whether 

they be lights and baubles on a tree, snowman figures, 

or dancing rock ’n’ roll reindeers that scare the dog. 
Every year we Say to ourselves that we want to 

make something a little special with our ready access 

to maker tools. Lights, code, and Raspberry Pis are 


DIY CHRISTMAS TREE 


Make your real Christmas tree better 
with some NeoPixels and code 
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Power up the festive season with a Raspberry Pi and some holiday magic 


all you need to create some cheap yet spectacular 
displays. You may have noticed that we’ve designed 
the cover this issue so that you can make it one of your 
displays, and we’1l go through how to do that over the 
next few pages. 

As well as creating a Christmas decoration with the 
magazine, we’ve got a couple of other projects you can 
do, including real Christmas lights and a fun Santa 
tracking system you can code yourself on Raspberry Pi. 


SANTA TRACKER Pl 


Follow Saint Nick as he makes 
his way around the world 
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Make a light-up tree out 
of the cover for a unique 
decoration this year 


The official Raspberry Pi magazine 


CHRISTM 
~ Jt LO Vee | VL 


Get creative with four festive projects 


Get started with 
prototyping on your Pi 


Wake at dawn with 
a sunrise alarm 


How to add a wealth of 
sensors to your Pi robot 
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HBBE§BEeueu#us8kessaiea#8aesiawsateuats8ssaeuais’sa Ba 4B 


EDs, LEDs, and @i@ireweEomlismiavescem likea 
lot to wire up 11 separate LEDs to the Raspberry 
Pi, but the effect should be superb once you’ve 


done it. We’ve tried to keep the code for this simple, 
with four different effects you can try to learn from! 


Set up your Christmas Pi 

We’re not going to do anything particularly fancy with 
the Raspberry Pi for this project, but we need to make 
sure it’s up to the task. Any Raspberry Pi will be able 
to do this; all we recommend is that you have some 


sort of network connection set up on the Pi, so you can 


access it remotely from another computer. 

Install Raspbian with PIXEL if you haven’t already. 
Update your Piwith sudo apt-get update followed 
by sudo apt-get upgrade, and connect to your 
network if you can. If you plan to control it over 
the network, you might want to change the boot 


behaviour in Raspberry Pi Configuration so that it goes 


Straight to the command line. This should save on a 
bit of power, and let it boot up a little quicker as well. 
Once that’s done, turn your Raspberry Pi off and 
wire up the circuit as shown in the diagram to test it. 

There are ten LEDs for the lights on the tree, and an 
eleventh LED that we’re using for the star. Follow the 
next page on how to wire up the lights to the cover... 
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You can use a breadboard to make wiring 


easier or you can wire up the LEDs directly 
to the Pi. Use any colours you wish! 
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>STEP-O1 

Cut out the holes 

We don’t usually condone 
defacing the cover of The MagPi 
— we do work hard on making 

it look fantastic for you! In this 
case, though, we’ve designed 

it so you can cut out little LED 
holes on the cover. Open up the 
magazine so the cover is laying 
flat against a cutting board. Use 
a craft knife or box cutter and 
carefully cut holes for the LEDs 
on the cover. If you’re feeling 
especially handy, you can always 
use a 4mm drill. Make the holes 
Slightly smaller than the LEDs. 
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Just in case you 
need to change 
the code, here's 

a reference for 
the GPIO pins 


_ 


N 
‘J 


FOHN 03 


FOHN 05 FOHN 1/ 


FOHN 01 


FOHN 14 


FOHN 07 
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>STEP-04 

Display it 

What good is a decoration if it doesn’t have a place 

to live? You’ll have to consider a place to stand the 
magazine, a way to stand it up (clear acrylic magazine 
stands are pretty cheap on eBay), and distance toa 
power source. Get it all programmed up over the page, 
get it in position, and your newest and (in our opinion) 
greatest decoration will be ready. 
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lightson py 


/usr/bin/et py thon 
gpiozero LED 
Star = LED(14) 
lights [LED(15), LED(18), LED(23), LED(24), 
LED(25), LED(8), LED(7), LED(12), 
LED(16), LED(20)] 


star.on() 


i range(10): 
lights[i].on() 
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With this code, we’ve 
modified it so that the LEDs 
that make up the tree lights 
will randomly turn on and 
off as they go, leaving 

seven on at all times. 


As will happen with 
the rest of the code, 
the star LED code will 
remain unchanged. 
We turn on seven 
lights in a similar 
fashion, then create 
a while loop to 
turn off a random 
light that’s on, and 
replace it witha 
light that’s off. 


in 1, A 


gpiozero LED 
random randint 
time sleep 


Star = LED(14) 


lights = [LED(15), LED(18), LED(23), LED(24), 
LED(25), LED(8), LED(7), LED(12), 
LED(16), LED(20)] 


star.on() 


i range(7): 
lights[i].on() 


turn_off = randint(0,9) 
turn_on = randint(@,9) 
lights[turn_off].is lit 
lights[turn_on].is_ lit 
lights[turn_off].off() 
lights[turn_on].on() 
sleep ( ) 


raspberrypi.org/magpi 


| candle flicker. py 


i b: T nN le n 


gpiozero PWMLED, LED 
gpiozero.tools random_values 
Signal pause 


Star = LED(14) 

lights [PWMLED(15), PWMLED(18), PWMLED(23), 
PWMLED(24), PWMLED(25), PWMLED(8), 
PWMLED(7), PWMLED(12), PWMLED(16), 
PWMLED(2@) ] 


star.on() 


i range(1@): 
lights[i].source = random_values() 


pause() 
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Create a Mexican wave on the 

cover! This is much harder to do 

on a real tree, so we thought 

we'd give it a go here first. It 

works very similarly to our 

previous code examples, but 

this time it only activates ei a. 


so many lights at a time. 
We use the toggle 
function of GPIO Zero gi 
to toggle LEDs on or — 
off, which also allows | oF 
us to make the code 
more efficient. 
This may involve a 
little trial and error, 
though, to make 
sure it’s all working 
well with your 
light arrangement. 


‘waves “Py 


/us in V/ 


gpiozero LED 
time sleep J 


Star = LED(14) 

lights [LED(15), LED(18), LED(23), LED(24), 
LED(25), LED(8), LED(7), LED(12), 
LED(16), LED(20)] 


star.on() 


while 


i range(3): 
lights[i].toggle() 
sleep( ) 
i range(3): 
lights[i+3].toggle() 
sleep( ) 
i range(2): 
lights[i+6].toggle() 
sleep( ) 
i range(2): 
lights[i+3].toggle() 
sleep( ) 
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> Pi Zero 


> RGB LED 
NeoPixel strip — 
enough length 
to wrap around 
your tree 


>» Level converter 
chip 3v - 5v 
(74AHCT125) 


> Female DC 
plug adapter 
magpi.cc/ 
2eD5eR3 


> 5V power supply 
(for DC plug) 


> Push button 


> Wires, 
breadboard 


Make your own turbo-charged fairy lights for a real Christmas tree 


ver the last few pages we’ve programmed 
and lit up the cover. We hope you’ve enjoyed 
doing that (send us a tweet with a picture to 
@TheMagP1!), but it may have left you in the mood 
for a slightly bigger project. 
iiictsw iene eStrip of NeoPixels comes in These 
are programmable RGB LED strips that easily connect 
up to a Raspberry Pi and can create some incredible 
displays. Let’s make them Christmassy... 
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Get a Pi ready 

NeoPixels work a bit better with first-generation 
Raspberry Pis, so we suggest using a Pi Zero or At 
to Save on space and power when making your tree 
lights. Install the latest version of Raspbian with 
PIXEL, and perform the customary sudo apt-get 
update and sudo apt-get upgrade on it. 


sudo apt-get install build-essential 
python-dev git scons swig 


Now download the library for the NeoPixels: 


git clone https://github.com/jgarff/rpi_ 
ws281x.git 

cd rpi_ws281x 

scons 


Finally, we can install the module on the Pi: 


cd python 
sudo python setup.py install 


Test circuit 

It will be easiest to build this up on a breadboard 
first. Follow the Fritzing diagram to do this. 

The strip is powered by an independent power 
source (the Pi can’t provide enough power to light 
the LEDs) and the signal from the Raspberry Pi is 
converted through the chip so it can be properly read 
by the stri@@eiiien oe weeesOmetimes comes 
with a multi-prong connector; you only need to use 
one of the wires to program the LEDs. If you look 
carefully, this wire will be connected to the middle 
DIN connector on the strip, and will very likely not 
be a red or black wire. 
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Make sure the chip is 
wired up properly so the 


> STE P- 0 3 signals can be converted 
Get the code 

Type up the code listing for this tutorial or download it to 
your Raspberry Pi. It’s Python code using a library that 
ports the normally Arduino code over to Python and the 
Pi. With the circuit wired up and the Pi switched on, run 
the code and see if it’s all working properly. 

When initially switched on, the first 30 LEDs should 
turn white. Pressing the push button will create a 
series of red and green lights that run down the strip 
in an endless loop. Finally, the last press will make 
them slowly pulsate with rainbow-coloured lights. 
Pressing the button again will renew the loop. 


>STEP-04 
Deck the tree 
Once you’ve done all your testing, it’s time to decorate 
the tree. It Giese smrerieeamnect the NeoPixels 
from the circuit before continuing. Wrap the tree with 
the NeoPixels (with the end at the bottom), and then 
cut between LEDs where you want the strip to end. If 
you have a waterproof covering, you can remove it now. 
Plug it all back in and do another test. You’1l now want 
to change the LED_COUNT number to represent the actual 
number of NeoPixels in the strip around your tree; you 
can either count them or use trial and error! 


>STEP-05 

Build a better circuit 

It might be a good idea to construct the circuit 
properly if you’re worried about the breadboard 
falling apart. The chip can be substituted for a diode 
which may make it easier (check the Adafruit website: 
magpi.cc/2fvshuy). You probably don’t want the 
lights on all the time either; if you want the program 
to run at boot, check out the boxout in the previous 
tutorial on how to get Python scripts to run at boot. 
Most importantly, though, enjoy your new lights! 
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A VERY RASPBERRY PI CHRISTMAS 


from gpioze 
from time i 


button = Bu 


LED COUNT 
LED PIN 

LED FREQ HZ 
LED DMA 
LED_BRIGHTN 
LED INVERT 


‘Neopixel_tree.py Ponquoge 


from neopixel import * >PYTHON 


ro import Button 


mport sleep DOWNLOAD: 


magpi.cc/NeoPixelTree 


tton (18) 
= 30 # Number of LED pixels 
= 14 # GPIO pin 
= 800000 # LED signal frequency in hertz 
= 5 
ESS = 255 # Brightness of LEDs 
= False 


def lights _on (strip, color): 


for i in 
strip.s 
strip.s 


range(strip.numPixels()): 
etPixelColor(i, color) 
how( ) 


def lights wave(strip, colori, color2): 


for q in 
for ii 
strip 
strip.s 


range(3): 

n range(@, strip.numPixels(), 3): 
.setPixelColor(i+q, color1) 

how( ) 


sleep(@. 2) 


for ii 
strip 


n range(@, strip.numPixels(), 3): 
.setPixelColor(i+q, color2) 


def color_wheel(pos): 


if pos < 
return 

elif pos 
pos -= 
return 

else: 
pos -= 
return 


def lights 
for j in 
for ii 
strip 

(Ci * 256 / 
strip 

sleep 


strip = Ada 
strip.begin 


while True: 
lights_on 
button.wa 
sleep(0.5 
while but 


85: 

Color(pos * 3, 255 - pos * 3, @) 
< 170: 

85 

Color(255 - pos * 3, 0, pos * 3) 


170 
Color(@, pos * 3, 255 - pos * 3) 


rainbow(strip): 
range(256): 
n range(strip.numPixels()): 


.setPixelColor(i, color_wheel( 
strip.numPixels()) + j) & 255)) 
. show() 

(@.1) 


fruit_NeoPixel(LED COUNT, LED PIN, LED FREQ HZ, 
LED DMA, LED INVERT, LED BRIGHTNESS) 


Q 


(strip, Color(255,255,255)) 
it_for_press() 


) 


ton.is_ pressed == False: 


lights_wave(strip, Color(255,0,0), Color(@,@,255)) 


sleep(0.5 
while but 


) 


ton.is_ pressed == False: 


ligthts_rainbow(strip) 


sleep(0.5 


) 
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Find out where Santa is on his journey around the world by visualising it on a map 


> Pygame Zero 


> Internet access 
on your Pi 


> Art assets 
magpi.cc/ 
SantaTrackerPi 


Use Pygame Zero to 


ather Christmas has got to make a lot of stops 
on Christmas Eve, but he somehow manages to 
do it anyway. He’s an impressive fellow; very 
spry for his age. What you might not know, though, is 
that it’s possible to track him throughout the night. 
NORAD uses its global satellite and radar systems to 
track Santa, but we have to make do with a little lower- 
tech solution on the Pi. Let’s get to work. 

For this project we’re going to use Pygame Zero; it’s 
a very easy way to create graphical representations on 
the Raspberry Pi. It’s already installed on Raspbian 
with PIXEL and makes use of the Pygame library 
to work. Make sure your Raspberry Pi is up to date 
with a quick sudo apt-get update followed by sudo 
apt-get upgrade in the terminal. 

You’ ll also want to make sure your Raspberry Pi 
boots to the PIXEL desktop, as we’ll be doing this all 


in a graphical environment. If you haven’t already, 
connect your Raspberry Pi to the internet, either via 
wireless or a wired Ethernet cable. For this code we 
require a constant connection to the internet. 
You’ ll also need to get the art assets 
for the program. Download them from 
magpi.cc/SantaTrackerPi and put them in a folder 
called images — we just need the two. 


Tracking Saint Nick 

Although we don’t have access to the same 
surveillance technology as the folks at NORAD, we 
can still make a pretty good approximation as to 
where Santa Claus will be at any given time. Since he 
always arrives at midnight, we can make an educated 
cuess that wherever it’s midnight in the world is 
where he'll be. 


Pygame Zero Game 


visualise Santa's movement 


across the world 


Thanks to all the time 
zones, Santa has 27 hours 


to do his job 


It's only a rough estimation 
of how much ground he's 
travelled — he's too fast to 
track everywhere 


ee 
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Different parts of the world operate at different times. 
San Francisco is eight hours behind the UK, and Tokyo 
is nine hours ahead. When it’s midnight in Japan, it’s 
only 3pm in the UK. With that in mind, we can take into 
account the full range of time zones, and calculate how 
far around the planet Santa has been at any point. Santa 
starts as early as 10am UK time on Christmas Eve, in 
the furthest reaches of the East, and finishes at midday 
Christmas Day at the International Date Line. 


Clever code 

We now know enough to make our program. Type it 
up or download it and save it as tracker.py; this and 
the images folder should both be in the same folder 
together. Here’s how it works. 

First, we set the stage. We have our Santa sprite, 
which we use the Actor class on so the code knows 
it’s a character sprite. We also set the width and 
height of the window. Once that’s done, we draw both 


the map image background and Santa onto the screen. 


Santa’s position is worked out by first finding out 
ioe emvamimeveyuse Coordinated Upikisaln inc 
(UTC), which is a constant. Luckily, it’s the same 
time as GMT, so if you live in the UK it’s a bit easier 
to understand. By finding it online using urllib, we 
know the exact time and don’t have to worry about 
any inaccuracies in the Raspberry Pi’s clock. We then 
parse it to remove the HTML from it, and look for the 
month, day, hour, and minute. This code will only 


work on Christmas Eve and Christmas Day, so we need 


to know exactly when the program is running. 


We then use if statements which check fo see if it’s 


the right time of yediiweitenl@dmmemehnstmas Eve 
UTC, and before midday Christmas Day UTC. If it’s 


not, we assume he’s about to start or has just finished, 


so we make his position reflect that using the pixel 
coordinates of the window we made. 0 is the far left, 
and 800 is the far right. 

If it is a time during his journey, we then calculate 
roughly where he is. Santa will be working over 27 
hours, so we know that each hour after 10am he’11 
have covered 1/27th of the map. We then also adda 
little bit, depending on the minute; this means the 
map will be more accurate, and also it’1] update every 
minute so you can track his progress. 


Run the script 

That’s all we need to do. Pygame Zero automatically 
loops the script a few times a second, so it’ll update 
live as Santa makes his way across the world. To run 
it, open a terminal, use cd to move to the folder with 
tracker.py and the images folder, and then use: 


pgzrun tracker. py 


Remember to Seaaieedstipeimeeamimen he comes to 
visit you, though, or you might not get any presents! 
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tracker.py 


>PYTHON 
urllib.request 
santa = Actor( ) 
WIDTH 
HEIGHT 
def draw(): 
screen.blit( »(0,0)) 
santa.draw() 
def santa_loc( ; ; Mi 
c_day : 
location1 = (WIDTH/27)*(c_hour ) 
location2 = ((WIDTH/27)/6@)*(c_minute) 
location1 = (WIDTH/27)*(c_hour ) 
location2 = ((WIDTH/27)/6@)*(c_minute) 
santa.pos = (WIDTH - (location1 + location2)), (HEIGHT/2) 


def update(): 


response = urllib.request.urlopen ( 

) 
web time = (response.read() ).decode( ) 
c_day = web _time[@:2] 


c_month 
c_hour 
c_minute 


web_time[3:5] 
int(web_time[11:13]) 
int(web_time[14:16]) 


c_month 
c_hour 
santa_loc(c_day, c_hour, c_minute) 


c_day 


santa.pos = (WIDTH), (HEIGHT/2) 
c_month c_day 

c_hour 
santa_loc(c_day, c_hour, c_minute) 


santa.pos = (WIDTH-WIDTH), (HEIGHT/2) 


santa.pos 


(WIDTH), (HEIGHT/2) 
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Amazing ideas for Raspberry 
Pi gifts this Christmas 


hristmas is the time for giving 

(even if you’re giving to yourself). 

And what more could a self- 
respecting Raspberry Pi maker want than 
one of the gifts here? 

We’ve scoured the Raspberry Pi market 
for some of the best gifts for a Raspberry 
Pi lover. From environment-sensing 
pHATs to portable games consoles, there’s 
something here for everyone. We’ve kept 
the prices low, so buying a Raspberry Pi as 
a gift won’t break the bank. And remember 
you can pick up a Pi Zero for just £4 / S6. 
You can check who has Pi Zero boards at 
magpi.cc/2fMveZh. 


PICO-8 


Fantasy Console Software 


PICO-8 is software that turns your Raspberry Pi 
into an amazing retro games console. It's rare to 
pay for software on the Raspberry Pi, but we think 
PICO-8 is worth it. There is a huge community 
providing games, and you can stop any game (at 
any time) and change the graphics, sound effects, 
and music using built-in tools. You can then learn 


to make your games. Great fun! Tc 
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Take environment and motion measurements 


The Enviro pHAT is packed with sensors for your Pi 
Zero (or any other Pi model). These enable you to 
measure temperature, pressure, light level, colour, 
motion, compass heading, and analogue inputs. It's 
like a smaller Sense HAT for your Pi Zero. 
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ZEROVIEW 


This clever 
cameramount —&% 
- co * screws onto your | la 

Se —_ Pi Zero and has suction | 

a cups to stick it to a window. Ideal for 
shooting time-lapse videos. 
£7/59 
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THE Oficial 
RASPBERRY PI 


TS BOOK 
PROJECTS BOOK 2 PROJECT: 


Fresh from The MagPi, the Official 
Raspberry Pi Projects Book is 200 pages 
stuffed full of Raspberry Pi goodness, 
tutorials, projects, and features. Available 


from Amazon, Barnes & Noble, WHSmith, 
The Pi Hut, and the Swag Store. 

£12.99 

magpi.cc/Back-issues 
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FREE 


Subscribe in print for six or 12 months to receive this stunning free gift 


Subscribe by 


7th DEC 2016 Subscribe today & receive: 


A free Pi Zero v1.3 (the latest model) 


to get your 


( ees 
FREE PI ZERO he > 


in time for 
Christmas! 


A free Camera Module connector 
A free USB & HDMI cable bundle 


Delivered with your first issue! 


Other benefits: 


Save up to 25% on the price 
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Projects Fess 


Inside the table is a 
Raspberry Pi used to control 
the pattern being created 


_~ BRUCE SHAPIRO 


Bruce grew up enchanted by music, 
od a 


electronics, and making things. He has 
devoted himself to using motion control 
for making art and education tools. 
magpi.cc/2fUUaRN 


Beneath the sand surface 
is a robot called Sisbot. 
This moves the ball using 
a powerful magnet 


A metal ball is pulled 
across a sand surface to 
generate a work of art 


30 


Each table is 
made in the US 


Bruce has 

been building 
Sisyphus tables 
for 20 years 


Sisyphus tables 
are displayed in 
museums and 
art galleries 


Components 
were picked to 
run quietly; it’s 
virtually silent 


Sisyphus is 
demoed at 
Northeast 
Minneapolis 
makerspace 
magpi.cc/ 
2eWKiEH 


ISYPHUS 


The incredible table that’s also a work of art (and a Raspberry Pi robot) 


ruce Shapiro is a maker 

and an artist. Unlike 

Picasso or Rembrandt, 
Bruce doesn’t paint with oil and 
brushes. “My medium is motion 
control,” he tells us. 

We caught up with Bruce to 
chat about his latest project, 
Sisyphus. Hot on the heels of 
a phenomenally successful 
Kickstarter campaign, Bruce 
has a lot to talk about. 


MagPi December 2016 


“Sisyphus is a computer- 
controlled machine that moves 
a magnet beneath a field of sand,” 
Bruce explains. “On the sand, a 
steel ball follows the magnet’s 
changing position, creating dune 
patterns in its wake.” 

In Greek mythology, Sisyphus 
was condemned to roll a boulder 
up a mountain for all eternity. 
“In my art, Sisyphus is a kinetic 
sculpture that rolls a ball through 


sand, forever creating and erasing 
beautiful patterns.” Bruce says 
that watching Sisyphus evokes a 
meditative feeling. 

“Initially, I viewed Sisyphus as a 
kinetic sculpture. I still do! But over 
the years, I began to see a parallel 
with the relationship between 
making musical instruments and 
writing songs. As different as 
these creative skills are, both are 
absolutely integral to the final art.” 


raspberrypi.org/magpi 


ttt} Y tt} (hf 4 ys ) ii 
fryyy si MME if 


ti Fee E. ' 2 
« 


\ 


without picking up your pen. If you The Sisyphus 
uit rd th itions of r table can contain 
uaa a re more than one ball; 


pends you draw, VYOUCam compose they work together 
fOL Sisyphus ») to create the artwork 


Controlling Sisbot 
A Raspberry Pi is the perfect 
computer to control the Sisbot 
and create the works of art, but 
it wasn’t always that way. “For 
a very long time, all my motion- 
control artworks were controlled 
7 by Windows PCs running DOS,” 
LLL —————_—_— SSS says Bruce. “In fact, three 
Gif WWWVUIEZ7; LLLLL _————_r —— S = WS still do, running every day in 
Yj/§ YJWHiik t ((((( \\ (© = Z = S—_S SX GG their museums. 

. KE ie SS “T don’t like change when it 
comes to something that works,” 
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I've been creating 
Sisyphus sculptures 
for nearly 20 years 


Bruce has been creating principle is the same: a toolpath Bruce admits. “Through many 
Sisyphus sculptures for nearly determines where the ball moves trials, and sometimes painful 
20 years, and has permanent and its speed. With Sisbot being a dead ends, I’ve learned that 
installations in Switzerland, polar machine, these moves endup community matters.” 

Germany, and Australia. producing spiral arcs, but this still It was the Raspberry Pi 

The heart of the project is the works since small arcs connected community that convinced Bruce 
Sisbot, a robot that controls the together can emulate any path. to switch over to a low-cost 
metal balls which create the “My patterns tend to be microcomputer. This was “more 
artwork in the sand. algorithmic since | never learned important than form factor and 

“Sisyphus is a CNC machine,” to draw,” Bruce continues. “But low cost,” he tells us. 
reveals Bruce. “It doesn’t use anyone can create paths for “The choice to use Raspberry 
G-code for its file format, but the Sisyphus — just draw something Pi in the new home versions of 
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Sisyphus was driven by all the 
30-somethings that I listen 

to,” says Bruce. The community 
informed him that JavaScript is 
essential and Node.js runs well on 
a Raspberry Pi. 

“The size of the community and 
its willingness to share makes the 
Raspberry Pi unique,” adds Bruce. 

The requirements of the 
Sisyphus table are complex. 
“Three levels are involved,” he 
explains. At the lowest level is 
“firmware written in C, running 
on the SisBotBoard”’. This was 
created by Brian Schmalz 
(magpi.cc/2fXxWhl) for an 


Grasshopper Rhino 3D plug-in.” 


The metal ball follows a 
path created using similar 
technology to a CNC machine 


earlier project Bruce created, 
called EggBot. “Brian started many 
years ago with the initial crude 
C code | wrote for running my 
steppers,” says Bruce. 
The second level is higher-level 
motion control, recently ported 
to JavaScript by Bruce and cleaned 
up considerably by Alex Wayne 
(magpi.cc/2fXDqs7). This code 
runs in Node on the Raspberry P1. 
The third level is algorithmic 
path generation. “I originally 
did this with AutoLISP routines 
running in vintage AutoCAD,” 
says Bruce, “but now I use the 
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History matters 

“T became fascinated with the 
challenge of connecting motors 
to my computer about 25 years 
ago,” Bruce recalls. “The easiest 
and most compelling way to 
demonstrate its potential is to 
create a machine that can draw, 
using just two motors.” 

EgeBot was Bruce’s first art 
machine. “[EggBot] rescued me 
from being locked up as a madman 
and for being so obsessed with, 
and talking incessantly about, the 
potential of hooking up motors to a 
computer,” he laughs. 

“{EggBot] is actually pretty 
cool,” he says, “and people | 
showed it to, for the most part, got 
that. spent many years building 
successively larger drawing 
machines that eventually were 
capable of moving cutting tools 
like plasma torches to enable me to 
cut out intricate shapes, mostly in 
metal, to make sculptures. 

“T fell in love with watching them 
move,” continues Bruce. “As I got 
better at designing new machines, 
the components that made them 
possible — stepper motors and the 
electronics that run them — were 
getting easier and cheaper to get 


— TS 
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x 
hold of. In 1998, Sisyphus became 
my first CNC machine to escape the 
Studio — transitioning from a tool 
used for making sculpture, to being 
the sculpture itself.” 

After 20 years of making, and 
refining, the Sisyphus project, Bruce 
was wary of making it available to 
buy. “Probably the biggest reason 
was not knowing how many people 
would respond.” 

He needn’t have worried. What 
Started out as a project to raise 


SISYPHUS 


$50,000 eventually ended up 


getting close to two million dollars. 


“When it comes to planning to 
make stuff for others, it helps to 
know how many will want it,” says 
Bruce. “Kickstarter is a very public 
Space to show what you want to do 
and find out how many people are 
supportive, not just with words, but 
with their hard-earned cash. It’s an 
amazing leap of faith on their part, 
something we’re still coming to 
erips with and take very seriously.” 
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Above Users can 
control the lighting 
of the table, as 
well as the speed 
of the metal balls 


» It was built at 
Microsoft's 
OneWeek 
Hackathon 
event for 
employees 


» It taps into 
the Face API 
from Microsoft 
Cognitive 
Services 


» ALeviton 
79A00 is used 
to lock and 
unlock the door 


» It uses a regular 
Microsoft 
Lifecam 
HD3000 


» C# was used to 
write the code 
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Faces are photographed 
using the webcam 


The door is unlocked 
when the Raspberry Pi 
confirms the identity of 
a person 


The Raspberry Pi is 
running Windows loT Core. 
It uses Microsoft Face APIs 
within Project Oxford to 
detect registered users 


DOOR 


This Raspberry Pi-controlled door can spot a face, and open up 
for people it knows - strangers get shown the (closed) door 


icrosoft has been busy 
making the most of 
the Raspberry Pi board 
with its Windows 10 IoT Core 
operating system. 
Windows 10 IoT Core might 
not be the home version of 
Windows 10 that some users 
would like on their Raspberry Pi. 
However, it taps into some pretty 
powerful services and enables 
hackers to create unique projects. 
“The Windows 10 IoT Core 
Facial Recognition Door is an 
example of a compelling new 
ocnicicatanvedmbe cleared 
when Windows 10 IoT Core is 
combined with Microsoft Cognitive 
Services,” says Masato Sudo, a 
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software engineer in the Microsoft 
Windows loT team. 

He explains: “It’s a prototype 
that identifies the visitor.” If the 
door recognises the visitor, it will 
ereet them by name, and the door 
will be unlocked and opened. 

“Tf it doesn’t recognise the 
visitor, it notifies the person that 
they are not recognised and keeps 
the door locked,” Masato tells 
us. They’re really shown the door. 

Facial recognition is no 
mean feat, but the hardware 
requirements are surprisingly 
light. Attached to the Raspberry 
Pi is a Standard USB camera to 
capture the face of prospective 
visitors. At the same time, a 


regular set of speakers is used 
to provide voice feedback 
to the guest. 

FC up WME! (6 Crone WO CIOLENa, 2 GIPIKO) joule’ 
is wired up to a relay switch. When 
the Raspberry Pi sends a signal to 
the GPIO, the relay switch unlocks 
the door. 

Finally, another GPIO pin is 
wired up to a doorbell. When the 
visitor presses the doorbell, it 
snaps a photo of their face, and the 
authentication process begins. 

“Windows 10 IoT Core is the 
brains of the project,” explains 
Masato. “For facial recognition, it 
uses a Microsoft Cognitive Services 
API that runs in the Microsoft 
Azure cloud.” 
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The Raspberry Pi is used to 
snap the visitor's face and 
authorise known users 


Microsoft Cognitive Services 
(magpi.cc/2eDbDM6) is the 
new name for Project Oxford. 
It “provides machine learning and 
artificial intelligence capabilities 
in the areas of vision, speech, 
language, knowledge, and 


it’s ahuman face before sending 
it for a face match.” 

If the image does contain a 
human face, it’s sent to the 
Microsoft Azure cloud to detect 
if it’s a match. “It searches 
matches of the face from the list 


If it does not recognise the 
visitor, it notiMes the person 
and keeps the door locked 


search,” explains Masato. For 
LIMe forte) cil, Ine Use! ie Wace NPI 
(magpi.cc/2eDb3xV). 

“We create a friends and family 
list, and add their pictures toa 
list in the Microsoft Azure cloud,” 
says Masato. “We used the Face 
API’s Face Grouping feature for 
this process. It’s used to sort faces 
into groups based on their visual 
similarity. After a picture is taken 
of the visitor at the door, it verifies 
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we created,” explains Masato, 
“and returns the confidence level 
of 0 to 100% on the likelihood of a 
face match. 

“We wrote our code in C# and 
used Visual Studio 2015 to code, 
deploy, and debug our project 
on Raspberry Pi,” he continues. 
“We shared our code with the 
Open-source community so 
that developers can enhance 
the security.” 
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» The loom took 
Fred a year 
to build 


» One Pi was 
accidentally 
fried in the 
process 


» The total 
component 
cost is 
around $150 


» Limit switches 
prevent the 
harnesses 
moving too far 


» The user needs 
to send the 
weft threads 
through 
by hand 


These custom-made 
motor control units feature 
12V relays and TIP 120 
Darlington transistors 


Connected to an actuator 
arm by a cord, each loom 
harness is lifted and lowered 
in sequence 


Controlled by the Raspberry Pi, 
four 12V DC motors are attached 
to actuator arms 


A weaving wonder controlled entirely by Raspberry Pi 


hen Fred Hoefler sent back 

a computer-controlled 

tabletop loom after it 
stopped working with his MacBook 
Pro, his wife Gina suggested that 
he should be able to build one with 
“one of those Raspberry Pi things 
of yours.” Fred recalls, “The most 
reasonable answer I could come 
up with was: ‘as a matter of fact, I 
think I can.’” A project was born 
(magpi.cc/2fDminE). 

At the outset, Fred set out some 
eround rules for building the new 
four-harness tabletop loom. As 
well as being controllable bya 
Raspberry Pi via the Bash console, 
no part of the hand-built loom was 
to cost more than the Pi itself. It 
would also need to be quiet enough 
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to carry On a conversation in the 
Same room with it. 

Following a year of work, with 
many stops and starts, the end 
result is a working Pi-powered 
loom that meets all Fred’s goals. 
“Basically, the Raspberry Pi drives 
four 12-volt DC motors turning in 
opposite directions, like a robot 
that rolls forward and backward,” 
he explains. “These motors are 
attached to actuator arms that 
are in turn attached to a cord that 
runs through a pulley system to 
individual loom harnesses.” 

FOrtinalehy ried Madson. 
(EN NCMS Sl CIOINICS Eiger merce 
from his earlier career as an 
aircraft mechanic and electrician. 
“T was quite used to working with 


wiring, relays, switches, and 
motors. Working with aircraft 
aluminium, making brackets 

and such is also second nature to 
me.” The project wasn’t without 
the odd mishap, however. As 
Fred discovered the hard way, 

“A Raspberry Pi cannot directly 
control common motor power. 
You must use some kind of motor 
control circuit. | thought I would 
try to use a half-bridge MOSFET 
controller (a TI SN754410) that 
claimed to be able to handle up 
to 1 amp, and have all sorts of 
protection between the power 
circuit and the GPIO circuit.” After 
one working motor test cycle, the 
result was a fried Pi: “We held an 
appropriate memorial.” 


raspberrypi.org/magpi 


PILoOM ‘Projects 


BUILD A 
~ PI-POWERED LOOM 


- ; 
; 
sd 7 


Fred Hoefler shows off his hand-built, 
Pi-powered loom - see a video of it 
working at youtu.be/QjqJOdjmbAY 


Each 12V motor moves an actuator 
arm with a cord attached viaa 
pulley to a loom harness 


To hissunprise, Fred had less While Fred admits the loom 
trouble programming a Python is too slow to use for production 
script (which can be found on purposes and requires an operator 
his website) to control the loom. to send the weft threads through 
“Python works like the old BASIC the shed by hand, he is looking to 
interpreters we used back in the improve it by experimenting with 


early 1970s, only easier. There are different 12V actuators and possibly 


Four 12-volt DC motors turn 1n 
opposite directions, like a robot 
that rolls forward and backward 


a 


lots of Python examples out there solar power. “Finally, I found that a 
explaining how to turn on and off the manufacturer of the ‘cute little >STEP-03 
GPIO pins... Once I set up how to loom’ that started this whole project 

control one harness witha module, has halted production due a supplier 

all I had to do was copy-paste a not being able to produce a reliable 

duplicate module and change the control unit. If we could just send 

calling parameters to control the him a copy of this article and offer to 

next harness.” upgrade the control unit...” 
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pi-top 


10 Hour 
Battery Life 


a 
HD Screen 


Modular 
Components 


$264° 


without Raspberry Pi 
ex VAT 


& 
[- to Worldwide shipping available in green or grey at www.pi-top.com 
Stay up to date with our Latest news by following our social media 


pi-topCEED 


Adjustable 
Viewing Angles 


14" 
HD Screen 


Modular 
Components 


$4 149° 


without Raspberry Pi 
ex VAT 


Available in green or grey colours 


CEEDuniverse 


CEEDuniverse is a world of fantasy 
grounded in computing reality! After 
crash landing on a strange new planet 
you will first encounter ‘drag and drop’ 
coding puzzles that improve your 
computational thinking skills. 


Discover more about the planet you've 
landed on and the civilisation that used 
to inhabit it while learning harder and 
more complex concepts in fun and 
engaging ways! Before long you'll be 
writing your own conditional 
statements, loops and functions. Find 
out more about CEEDuniverse at 
www.pi-top.com 


pi-topCODER 


Influenced by the workflow of makers 
and hackers, pi-top presents 
pi-topCODER - an integrated code editor 
which allows you to learn, write and test 
code all in one view. With intuitive 
syntax highlighting, dynamic views and 
customizable themes it makes for a 
versatile learning tool for your projects. 


pi-topCODER also has every Raspberry Pi 
Foundation lesson plan created and will 
track and save your progress as you go 
through dozens of fun hardware and 
software projects. 


q ‘ 
pi-topPROTO pi-topsPEAKER 
pi-topPROTO is a HAT compatible Give a voice to your pi-top device 
Add-on Board for your pi-top or with pi-topSPEAKER! 
pi-topCEED that allows you to 
prototype electronics. Create a e Modular design, attach up to three 
Weather Station, HAM Radio, Heart in a row to give true stereo sound. 
Rate Monitor, or integrate any e 2W per module 
Arduino based maker kits into your e Left, Right and Mono mix selection 
own Raspberry Pi compatible e High quality SPDIF digital audio 
prototyping board! from HDMI 
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This humble plastic block full of holes can be used to create just about anything 
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40-pin 
models only 


USB Ports 


Discover the easy way to control GPIO pins on your Raspberry Pi 
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>STEP-07 

Adding a button 

Now we’re going to add a button to our circuit and 
connect it to GPIO21 with an LED wired up to GPIO17. 
Buttons are wired up ina Similar fashion to LEDs, 
using female-to-male jumper leads. 

Like LEDs, buttons have legs. One leg is wired to a 
GND pin (via the same ground rail you’ve been using 
for LEDs); the other leg is connected to a GPIO pin. 
Some buttons have four legs, so you can connect 
them to the breadboard with their legs straddling 
the central groove (see the breadboard diagram). 


>STEP-08 

Button responder 

Unlike LEDs, you don’t need to use a resistor with a 

button. The button’s legs are the same length, and it 
typically doesn’t matter which way around you hook 
it up to the breadboard. 

When the button is pushed, it forms a connection 
between the ground rail and the pin, completing a 
circuit. The Raspberry Pi is set up, using GPIO Zero, 
to detect this connection and respond. 

Open Python shell and create a new file. Enter the 
code from button.py, save the file, and run the code. 
When you push the button, the LED will light up. 
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Going further 


You can achieve a lot more with GPIO Zero than 
controlling LEDs and buttons. 


motion, control robots, read sensor information 
(such as movement sensors or thermometers), 

The MagPi's Phil King has created a fantastic guide: 
MagPi Essentials: Simple Electronics with GPIO Zero. 
Learn more at magpi.cc/Back-issues. 
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>PYTHON 


button.py 


from gpiozero import LED, Button 
from signal import pause 


led = LED(17) 
button = Button(21) 


button.when_pressed = led.on 
button.when released = led.off 


pause() 


traffic_lights.py 


from gpiozero import LED 
from time import sleep 


red = LED(25) 
amber = LED(8) 
green = LED(7) 


green.on() 
amber .off() 
red.off() 


while True: 

Ssleep(10@) 
green.off() 
amber .on() 
sleep(1) 
amber .off() 
red.on() 
sleep(1@) 
amber .on() 
sleep(1) 
green.on() 
amber .off() 
red.off() 


For a more detailed look at how you can detect 


DOWNLOAD: 
magpi.cc/2ehTqVq 
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Remotely control your Pi from another computer with VNC Server and Viewer 
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Menu -) mo = Be ) “WD func.c - /home/pi - Ge MB pi@raspbery: ~ 


istebasket 


int sum_and_diff (int 4, int b, int *res)} 


int sum: 

Sum = 6+ Bb: 
‘res = a - b; 
return sum; 


OO OU 


11 wold main (woid) 
{ 


13 int b = 2: 
14 int diff: 


printf ("The sium af S&S and “1 is ‘d'\n*, 
printf (‘The difference of 5 and Ad is ‘din", b, diff): 
} 


— im mb 
coos mi 
poe 


A function definition consists of a return 
type, a function name, and a List of 
arguments enclosed in round brackets 


b, sum_and diff (5, b, Gdiff)); 


A function must return a 
value of the same type as 
stated in its definition 


AN INTRODUCTION TO C 


FUNCTIONS 


Functions — how to split your code up into easy bite-size chunks... 


ll the examples we’ve looked at so far 
have had one function, main, with all the 
code placed within it. This is fine for small 
programs, but it’s not really practical when code 
gets bigger, and it wastes space if you need to do 
the same thing more than once. Splitting code 
into functions makes it more readable and enables 
easy reuse. 


RETURNING 
VALUES 


A function can 
return a single 
value, or no 
value at all. If 
you define the 
function as 
returning void, 
there's no need 
to use areturn 
statement in it, 
but you'll get 
an error if you 
don't include 
a return of the 
correct type 

in anon-void 
function. 


Above You can use a function call wherever a variable of the 
same type as the value returned by the function could be used 
- in the code here, a call to sum_and_diff replaces an integer 
value in the arguments to printf 
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We’ ve already seen functions used; the main function 
is a Standard C function, albeit with a special name. 
We’ve also seen the printf function called by our 
examples. So how do we create and use a function of 
our own? Here’s an example: 


#include <stdio.h> 
int sum (int a, int b) 
{ 

int res; 

res = a + b; 

return res; 


} 
void main (void) 
{ 
int y = 2; 
int z = sum (5, y); 


printf ("The sum of 5 and %d is %d\n", y, Z); 


This example includes both the main function 
and a second function, called sum. In both cases, the 
structure of the function is the same: a line defining 
the value returned by the function, the function name, 
and the function arguments, followed by a block of 


raspberrypi.org/magpi 


code enclosed within curly brackets, which is what the 
function actually does. 


What's in a function? 


Let’s look at the sum function: 
int sum (int a, int b) 


The definition of a function has three parts. The 
first part is the type of the value returned by the 
function: in this case, an int. The second part is the 
name of the function: in this case, sum. Finally, within 
round brackets are the arguments to the function, 
separated by commas, and each given with its type: in 
this case, two integer arguments, a and b. 

The function’s code is between the curly brackets: 


int res; 


This declares a local variable for the function, an 
integer called res. This is a variable which can only 
be used within the function itself. Variables declared 
within a function definition only exist within that 
function; if you try to access res from main, you’ Il get 
an error. 


res = a + b; 


Here, a and b are the arguments of the function. 
When a function is called, a local copy of the 
arguments is made. If you change the values of a or b 
within the function, that only affects the local values; 
it doesn’t change the values that the arguments had 
in the function from which it was called. 


return res; 


Finally, we return the result. The function was 
defined to return an integer, therefore it must call the 
return statement with an integer to be returned to 
the calling function. 

A function doesn’t have to return a value; if the 
return type is set to void, it returns nothing. In this 
case, a function will return when it reaches the last 
line, but if you want to return early (in the event of an 
error, for example), you just call return with no value 
after it. 


Calling a function 


Let’s look at how we call the function from main: 
int z = sum (5, y); 


The sum function returns an integer, so we set an 
integer variable equal to it. The arguments we supply 
to the function are inside round brackets, and in the 
Same order as in the function definition: ais 5, and b 
is the value of y. 
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AN INTRODUCTION TO C 


You can only return one value from a function, but 
you can also use pointers to pass multiple items of 
data back to the calling function. Take this example: 


#include <stdio.h> 
int sum_and_ diff (int a, int b, int *res) 
{ 
int sum; 
sum = a + b; 
*res = a - b; 
return sum; 
} 
void main (void) 
{ 
int b = 2; 
int diff; 
printf ("The sum of 5 and %d is %d\n", b, 
sum_and diff (5, b, &diff)); 


printf ("The difference of 5 and %d is %d\n", 


Tutorial 


VARIABLE 
SCOPE 


If you declare a 
variable within 
a function, it’s 
only usable 
within that 
function, not 
within any 
functions 
Which call the 
function, or 
within functions 
called by the 
function. This 

is known as 
the scope of 

a variable: the 
parts of the 
code in which 
it is valid. 


b, diff); 


The sum is returned as before, but we’re also passing the difference 
back using a pointer. Remember that the arguments to a function are 
local variables; even if you change one in the function, it has no effect 
on the value passed by the calling function. By passing a pointer, the 
function doesn’t change the value of the pointer itself, but it can change 


the value in the variable to which it points. 


So we call the function with the same two arguments as before, but 
we add a third one, a pointer to the variable where we want to write the 
difference. In main, we call the function with the address of diff as 
the pointer argument to the sum_and_diff function; the difference is 


written into diff in the main function. 


Order matters 


One thing to bear in mind when defining functions is that the compiler 
reads files from top to bottom, and you need to tell it about a function 
before you can use it. In the examples above, this is automatic, as the 


definition of the sum and sum_and_diff functions is 
before the first call to them in main. 

But in larger files, when multiple functions call 
multiple other functions, this gets complicated; it’s 
not always easy to make sure the function definitions 
are all in the right order. To avoid this, C allows you to 
declare functions before they’re used. 

A function declaration is just the definition of the 
function, minus the function code within the curly 
brackets. So for the sum_and_diff function, the 
declaration would be: 


int sum_and_diff (int a, int b, int *res); 


Note the semicolon at the end! Function 
declarations are included at the top of the file. 
When the compiler finds a function declaration, it 
knows that at some point a function with this name, 
arguments, and return type will be defined; it then 
knows how to handle a call to it, even if it hasn’t yet 
seen the definition itself. 


ARGUMENTS 


A function 

can have any 
number of 
arguments, 
from zero up 
to hundreds. If 
you don't need 
any arguments, 
you list the 
arguments 

as (void) in 
the function 
definition (just 
like in the main 
function); when 
you call the 
function, just 
put a pair of 
empty round 
brackets 

() after the 
function name. 
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4x Tilt switches 
5x ribbon cable 
MDF board 
anta has a problem, and he needs your help. 
He has landed on an ice-covered flat roof and 
the reindeers can hold firm, but Santa and 

the elves are sliding about all over the place. Can you 
help out by tilting the roof to guide Santa and his 
presents down the chimney? Make sure you don’t lose 
an elf down it, though. 


Strip pine 
and glue 


ns Toe ts < | 
Ben @ i BG Be 
—_ { - 


The game is a puzzle - get 
, a Santa and the presents 
es down the chimney 
wa *s GP, Z 
. et. € Tilt controller used 
a, pay for playing the game 
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SLIDERS 


A simple but unique interface controls this Christmas puzzle 


Slider game 

The Sliders game is placed on a5 by 5 grid; the object 
of the game is to deliver the presents down the 
chimney without losing any of your ‘helpers’. Your 
cast consists of reindeer who helpfully (or not) stay 
fixed throughout the game, and elves who helpfully 
(or not) slide with Santa and his presents. Once 

you tilt the sensor, all the sliders slide in the same 
direction until they hit a reindeer, the end of the 
board, or another character. Once they’re sliding 
there’s no stopping them, no matter what you do with 
your tilt controller. As the chimney is at the centre of 
the grid, there’s no way to get at it without the help 
of the other characters. The setup for each puzzle is 
eraded into one of four difficulty levels, which range 
from easy to downright fiendish. 


Physical interface 
The controller is very simple. It consists of four tilt 
switches, arranged in a square base pyramid, so that 
normally none of the tilt switches are activated; 
that is, the ball is at the bottom of the tube. As this 
arrangement is tilted in a cardinal direction, just one 
of the tilt switches activates. Each switch is connected 
to a GPIO pin with the internal pull-up resistors 
enabled. The schematic is shown in Fig 1, and full 
details of the construction are in the steps overleaf. 
You first need to get some images of each 
character, including the chimney, with a transparent 
background. These need to be 112 by 112 pixels in 
size. Clip art is a good source if your drawing skills 
aren’t up to much. You can find the images we used 
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SLIDERS Tutorial 


Fig 1 The controller 
comprises four 
tilt switches 


UP 


GPIO 27 


GPIO 17 
GPIO 4 
GPIO 22 
LEFT 


RIGHT 


Gnd 


DOWN 


in our GitHub repository. You’ll also need to getsome The loadResources function assembles all the 


sound samples: a short jingle of bells to accompany individual images into a piece list and, as the zeroth 

the sliding, and a triumphant finished sound. In element is not used, we simply make it a copy of the 

addition, you’1l need sounds for the presents and the first element, which saves complications further on 

elves plunging down the chimney, as wellasalostand inthecode. 

won splash screen. What makes the game look good is the smooth 
sliding to one end of the board. This can be a problem 

Create the software because sometimes a character can’t move, and 

The Sliders.py code listing is shown overleaf. sometimes they can only move so far because other 

It’s written with the Pygame framework and the things are blocking them. The trick to fix this is to 

heart of it is the showBoard function. This draws a only move one adjacent square at atime. At theend _» 

chessboard ina 5 by 5 grid, and places the character of this, a list is made of all the characters that could 

images based on the information in the board list. move; if there are none then the slide is complete. 

In fact, this was the first function we wrote, and we Otherwise, the move list is applied again to one 

expanded the program around it. The board list is 25 adjacent square. Thus, ina series of single moves, all 

elements long and shows what character number is the pieces end up in the right place, and the speed 

in what square, with zero indicating no character. of the Pi makes it look like a smooth continuous 
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Tutorial | WALKTHROUGH 


Make the switch support 
dg 01 Cut four pieces of 12x6mm strip pine 30mm long. Mitre 
the ends at a 60 degree angle; we used a disc sander 


for this. Take two pieces and glue them together at 

the mitre point. When set, make the other ends level 

by pushing it onto the disc sander. Take the other two 
ey / OY : 0 2 pieces and glue them to the mitre joint of the first two, 

and again sand flat when set. Flood the whole joint with 


epoxy for added strength. 


Wiring up the switches 
Wire up the switches to the ribbon cable. Put the 
cable on the back of the mount and bring up the wire 
to the top. Fix the ribbon cable on the underside with 
0 3 a double-sided foam pad. Use the same to fix the tilt 

: switches to the arms of the switch support. At this stage 
test the switches, because wiring might be difficult after 
the next stage. You can do this with a continuity meter, 
or wire them up to the Raspberry Pi. 


Add the base 
Cut a piece of 52x72mm MDF of 7mm thickness for the 
base and glue the switch support to it. Clamp them 
together while the glue sets. Make sure the switches 

a 0 (= are wired up to the correct GPIO pins, as shown in the 
photograph. Note that we used two different styles of 
tilt switch for the simple reason that this is what we had 
to hand. You might want to paint the finished unit. 


move. The move animation is done in a loop by 
redrawing the original and destination square of each 
moving character, and then drawing the character 
over this in a position slightly further over to the 
destination square. When the loop is completed, the 
character is in a new position, so the board list is then 
updated and the positions of the pieces checked to 
see if anything is in the chimney square, normally 
indicating the end of the game. A new move list is 
eenerated to see if any more sliding is needed. The 
only complication with this is that the adjacent 
square’s position changes depending on the sliding 
direction, which means that the magic numbers 

have to be replaced by variables set when the slide 
direction is determined. 
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Reading the tilt switches 

The tilt switches are read individually, but are 

then placed into various bit positions of a single 
variable. This allows us to read the slide direction 
as a single number. With four switches, there are 16 
combinations, but we’re only interested in five: the 
four tilt directions and no tilt. This is done in the 
getSensor function, working with getMove. 

The initial starting position for each game is defined 
in the LoadResorces function and is split into four 
degrees of difficulty. You can choose what level of 
difficulty you want to play, and the setup position is 
chosen at random from that 
level. Pressing the R key 
will restore the original 
setup, while the space 
bar abandons a game 
and creates a new setup 
at the chosen level. 
Pressing the RETURN 
key will take you back 
to the level select 
screen. If you lose an 
elf down the chimney, 
you get to play the 
same game again. 


rd 


Taking it further 
The code printed here has 20 different setups; in the 
GitHub repository (magpi.cc/1NqJjmV) there’s also a 
version with 40 different setups, as well as a version 
you can play using your keyboard to control the tilt 
with the cursor keys. You can customise the icons and 
the sounds very easily, or you can keep a track of the 
score. You might want to play each setup in order and 
not choose one at random, or, for the more advanced 
hardware people, even replace the tilt switches with 
an accelerometer. 
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SLIDERS ‘Tutorial 


Sliders.py 
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25:5 
. gameOver = True ; newLevel = True 3; sameGame = False 


# Pi Christmas Sliders Game 20 setups 
# By Mike Cook - October 2016 


import pygame, time, os, random 
import wiringpi2 as io 


pygame.init() # initialise graphics interface 
pygame.mixer.quit() 

pygame.mixer.init(frequency=22050, size=-16, channels=2, 
buffer=512) 


os.environ[ 'SDL_VIDEO_ WINDOW _POS'] = ‘center’ 
pygame.display.set_caption("Slider - The Pi Christmas Game") 
pygame.event.set_allowed(None) 
pygame.event.set_allowed([pygame.KEYDOWN, pygame.QUIT | ) 
screenSize = 560 

screen = pygame.display.set_mode([screenSize, screenSize ], 2,32) 
textHeight = 36 ; sq = 112 # square size 

font = pygame.font.Font(None, textHeight) 

random. seed() 


move = @; moveInc = 0; moveIncX = @; movelIncY = @ 
tiltPins = [| 4,17,27,22] 

squareG = [ (475,175,175) ,.( 255,255,255) | 
board = | 2,0,;5,0,0, 3,0,0,0,0, 0,0,1,0,0, 
0, 0,2;0,;3 | 

moveList = [0,0, 0,0, 0,0, 0,0, 0,0, 20,0] 


0,0,4,0,0, 


currentGame = @ ; gameLevel = 0 


29. def main(): 


global move, gameOver, newLevel 
loadResorces() 
initGPIO() 
print"The Pi Christmas Game" 
while True: 
checkForEvent () 
if gameOver: 
if newLevel: 
selectGameLevel() 
newLevel = False 
makeNewGame ( ) 
waitLevel() 
#print "table level" 
time.sleep(1.0) 
gameOver = False 
lastMove = @ 
move = 0 
while (move == lastMove or move == @) and (not gameOver): 
# wait for a move 
getMove(getSensor() ) 
lastMove = move 
if move!= @ and not gameOver: 
gameSound[@].play() 
while move != @ and not gameOver: 
# move all to the side of the tilt 
makeMoveList () 
s=0 
while s <= 1.0: # move free pieces one square 
showMove(s) 
St= 0.05 
updateBoard() 
showBoard( ) 


def getSensor(): 
global move 
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Tutorial WALKTHROUGH 


Gon sensor = @ 3 2 screen.blit(piece[ 3], (screenSize-140,cp+40) ) 
66. checkForEvent() 15a screen.blit(piece[4],(cp-60, 60) ) 
ewe for pin in range(@,4): 134. screen.blit(piece[5], (cp-60,screenSize-180) ) 
68. sensor = (sensor << 1) | ( 135: pygame.display.update() 
io.digitalRead(tiltPins[pin]) ) 136. 
69. return sensor 137. def makeNewGame(): 
7®. 138. global board, gameOver, setup,sameGame, currentGame 
71. def selectGameLevel(): 139; for s in range(@,25): # Wipe board 
TOR global gameLevel 140. board[s]=0 
ie drawLevelScreen() ale if not sameGame : 
74. waitLevel() 142. temp = currentGame 
(hoe drawSelectScreen() 143. while temp == currentGame: 
76% getMove(getSensor()) 144. currentGame = random.randint(gameRange|[ gameLevel 
TT: while move == @: -1]+1, gameRange[ gameLevel ] ) 
78. getMove(getSensor() ) TAS. game = setup[currentGame ] 
79. gameLevel = move 146. elements = len(game) 
8. #print"game level ",gameLevel, " selected" 147. #print"playing game ",currentGame 
81. 148. for s in range(@,elements,2): 
82. def waitLevel(): # hold until the platform is level 149. board[ game[s+1]] = game[s] 
Sse table = getSensor() 150. board[12] = 1 # always the chimney 
84. while table != 15 : 151 gameOver = False 
C5: firstLook = getSensor() 152. SameGame = False 
86. time.sleep(1.0) dle) ie showBoard() 
37. secondLook = getSensor() 154. 
88. if firstLook == secondLook : 155. def updateBoard(): 
89. table = firstLook 156. global board, gameOver, sameGame 
90. 57. for c in range(@,12,2): 
91. def getMove(sensor): 153% if moveList[c+1] > 2: # not chimney or reindeer 
eZ. global move,moveInc,moveIncX,movelIncyY, piece P59: board[moveList[c]] = @ # remove piece 
93. move = @ 160. board[moveList[c]+ moveInc] = moveList[c+1] 
94. if sensor == @xd: # up 161. # new piece position 
95. move = 1 162% if board[12] == 3; 
OG. moveInc = -5 Tos) gameOver = True # lose 
SE moveIncX = @ 164. gameSound[1].play() # elf scream 
S35); moveIncY = -1 165. SameGame = True 
99. if sensor == @x7: # down 166. screen.blit(loseImage, (0,60) ) 
100. move = 2 MGT. pygame.display.update() 
101. moveInc = 5 168. time.sleep(3.0) 
102. moveIncX = @ 169. board[12] = 1 
103. movelIncY = 1 170. if eoOard|12\|9—— 4.07 boaral12| == 
104. if sensor == Qxe: # right 171. gameSound[2].play() # present delivery sound 
165. move = 3 172. board[12] = 1 
106. moveiInc = 1 L7S% finished = True 
107. moveIncX = 1 174. for s in range(@,25): 
108. moveIncY = @ 1/5: if board|s|) == 4 or board[s] == 5% 
109. piece[4] = santaFlip 176. # see if anything left to deliver 
110. if sensor == @xb: # left as finished = False 
a ie a move = 4 73: if finished : 
ii2. moveiInc = -1 179. gameOver = True # win 
aS. moveIncX = -1 180. screen.blit(winImage, (0,60) ) 
114. moveIncyY = @ 181. pygame.display.update() 
aA: piece[4] = santa 182. time.sleep(2.0) 
116. 183. gameSound[3].play() # finish 
117. def drawLevelScreen(): 184. time.sleep(2.0) 
118. cp = screenSize/2 185. 
119. pygame.draw.rect(screen, squareC[0],(0,0,screenSize, 186. def makeMoveList(): 
screenSize) ,@) 187. # add to move list if not wrap round/space to move into 
120. drawWords("Set platform level", cp-100,cp-10@) 188. global moveList,move 
lea pygame.display.update() 189. c=0 
122. 190. for i in range(0,12): 
123. def drawSelectScreen(): oie moveList[i] = @ # remove all moves 
124. cp = screenSize/2 92. for square in range(@,25): 
125. pygame.draw.rect(screen, squareC[0],(0,0,screenSize, 193. if board[ square] > 2: 
screenSize) ,@) 194. if not findWrap(square): 
126. drawWords("Tilt to select Game Level",cp-140,cp-100) 195. if board[moveInc + square] < 2: 
127 drawWords("Ultra Hard",20,cp) 196. moveList[c] = square # place piece 
128. drawWords( "Hard" ,screenSize-18@,cp) 197. moveList[c+1] = board[ square] # piece type 
129. drawWords("Easy",cp-40, 20) 198. c += 2 
130. drawwWords("Medium",cp-50,screenSize- 6@) 199. lap (= 
131. screen.blit(piece[2],(10,cp+40@) ) 200. move = @ # finished moving 
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def findwWrap(square): 
wrap = False 
y = int(square / 5) 
x = (square - (y * 5)) 
Xw = X + moveIncxX 
yw = y + moveIncY 
if xw>4 or xw <@ or yw > 4 or yw < @: 
wrap = True 
return wrap 


def showMove(movePart): # move all on the move list one square 


for c in range(@,12,2): 
if moveList[c+1] !=0: 
y = int(moveList[c] / 5) 
X = (moveList[c] - (y * 5)) 
if moveList[c+1] > 2: 


drawMove(moveList[c+1],x*sq+(sq*movelIncX*movePart),y*s 


q+(sq*moveIncY*movePart) ,moveList[c],x*sq, y*sq) 
pygame.display.update() 


def drawMove(character, x,y, Square, Sx,Sy): 


pygame.draw.rect(screen, squareC[ square & 1],(sSx,Sy,Sq,Sq),®) 


# from square 


pygame.draw.rect(screen, squareC[ (square & 1)%1], (sx+(sq*move 


IncX) ,sy+(sq*moveIncY),sq,sq),@) # to square 
screen.blit(piece[ character ], (x,y) ) 


def showBoard(): 
c=1 
for x in range(@,5): 
xp = we IW 
for y in range(@,5): 
Yp-= y - ie 
C. SG 


pygame.draw.rect(screen, squareC[c], (xp,yp,112,112),0) 


for square in range(@, 25): 
int(square / 5) 
x = (Square - (y * 5)) 
if board[square] != @ : 
screen.blit(piece[board[ square] ], (x*sq,y*sq) ) 
pygame.display.update() 


< 
ll 


def drawwWords(words,x,y) : 
textSurface = pygame.Surface((14,textHeight ) ) 
textRect = textSurface.get_rect() 
textRect.left = x 
textRect.top = y 


textSurface = font.render(words, True, (@,0,90), squareC[@]) 


screen.blit(textSurface, textRect) 


def initGPIO(): 
Ley 4 
io.wiringPiSetupGpio() 
except : 


print"start IDLE with ‘gksudo idle' from command line" 


os. _exit(1) 
for pin in range (0,4): 
io.pinMode(tiltPins[pin],@) # mux pin to output 


io.pullUpDnControl(tiltPins[pin],2) # input enable pull up 


def loadResorces(): 
global gameSound, piece, winImage, loseImage, santa, 
santaFlip, setup, gameRange 


chimney = pygame.image.load(“images/chim.png").convert_alpha() 


elf = pygame.image.load("images/elf.png").convert_alpha() 


rainD = pygame.image.load("images/raini.png”).convert_alpha() 
santa = pygame.image.load("images/santa.png").convert_alpha() 
santaFlip = pygame. image. load("images/santaFlip.png").convert_alpha() 
present = pygame.image.load("images/present.png").convert_alpha() 
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anta, present ] 
winImage = pygame.image. 
load("images/win.png").convert_alpha() 
loseImage = pygame.image. 
load("images/lose.png").convert_alpha() 
soundEffects = ["bells","elfScream", " 


HOHOHo" , 


gameSound = [ pygame.mixer.Sound 
("“sounds/"+soundEffects[ sound ]+" .wav" 
for sound in range(@,4) | 


SLIDERS 


= [chimney,chimney,rainD,elf,s 
>PYTHON 2 


DOWNLOAD: 
magpi.cc/1NqJjmV 


"finish" ] 


PROJECT 
VIDEOS 


Check out Mike's 
# Easy Bakery videos at: 
gi = [4,0,2,1,2,22]; magpi.cc/1NqJnTz 
p2 = |(2,0,451,3,;2\5 
o3 =.(3,.0;4.1, 252.320, 5,21)| 
pa = (2,0,4,4,5,24,3;20)|: ¢5 = [3,0,3,5,3,2,;4,1,5,7,2,6| 
# Medium 
Bova G) 2.4) 4) G5) 27 1 
ey Nie sor ale a 
Beau | Oh 1420 6 87 Ae Stes 4. 
Rev yest eo cy 
pipe] eos sedese aaa ce os 4a] 
# Hard 
Gl Gn2 Ano de 7 | 
e120 )= (22.4.3, 354,2,6,5,9,5,24) 
pis 2) (Dhaba leo. aoe a ay 
pid= [20,207 4-85-02 13,2143 48) 3.104 
lis [Poe Palen ei SIG eyo Diy ace el eh rel] 


# Ultra hard 


g16 = 
g17 = 
g18 
g19 = 
g20 = 
setup 
g15,g16 


[2d 2,252,407,2) 21,4 16,55, 23,3,22 3.18 | 

20s 25 bo 254 45 55 Oy 35 1052522 | 
[25205252252 2352517 y2) 15,4 518,55 24,35, 19)| 
[258525552505 25 1852,23555 17 .5,22,4,16,5,21 | 
(2,2;2;752,10,4,1,5,5,3,6,3,5;3,15] 

= [g1,g1,22,23,24,25,26,87,28,289,g10,g11,¢g12,¢13,¢914, 
»£17,g18,¢19,g20| 


gameRange = [@,5,10,15,20] 


def terminate(): # close down the program 
print "Closing down please wait" 
pygame.mixer.quit() 
pygame.quit() # close Pygame 
os. _exit(1) 


def checkForEvent(): # see if we need to quit 
global move, gameOver, piece, newLevel, sameGame 
event = pygame.event.poll() 
if event.type == pygame.QUIT : 
terminate() 
if event.type == pygame.KEYDOWN : 


aj 


ih 


event.key == pygame.K_ESCAPE : 
terminate() 
event.key == pygame.K_r : 


a 


agg 


gameOver = True # abandon game 
SameGame = True # don't set new level 
move = @ 


event.key == pygame.K_RETURN : 


gameOver = True # abandon game 
newLevel = True # set new level 
move = @ 


event.key == pygame.K_SPACE : 


gameOver = True # start game again 
move = @ 


# Main program logic: 


if _name__ == '_main_': 
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1) LY SUNRISE 
ALARM 


2x LEDs 

Light-dependant 

resistor (LDR) 

330nF ceramic 

it e e 

hag Use a breadboard and simple components to sense light levels and 

Buzzer ° : 1 | 

ere activate a loud (and blinky) alarm to wake you up each morning! 

resistors 

es ith the help of some exciting code and >STEP-01 

i ciore some clever electronics, you can use your Connect the resistors 

Bo Mca Raspberry Pi to read an analogue signal froma Once you have the components, begin to make the 

female jumper photoresistor without the need for a conversion chip! circuit by connecting up the resistors. Do this as shown 

wires Armed with this power, you can measure the ambient in the circuit diagram, pushing each component’s legs 

3x Male-to-male light level and trigger an effective alarm. The project is into the holes in the breadboard. Ensure that the bottom 

jumper wires designed as an extension to the projects found in the two resistors are 470Q. (yellow, purple, and brown), and 

Or Monk Makes Monk Makes Raspberry Pi Electronics Starter Kit. the top two are 1kQ, (brown, black, and red). 

Raspberry Pi 

Electronics _ 

Starter Kit . 7 STE P 0 2 

magpi.cc/ Dial es hash to Str Add the rest of the components 

: you from your slumber 

zeCgsjz Next, add the LEDs, making sure that the long legs 
Even the deepest sleeper couldn't : 
sleep through the (annoying) noise are connected towards the bottom of the diagram, 
made by the buzzer! as shown. The flat side of the LEDs should be facing 


towards the 1kQ resistors. When connecting the 
buzzer, the longest leg should be facing the bottom 
of the breadboard. Finally, connect the LDR and 
capacitor. These can be connected in any orientation. 


>STEP-03 

Connect to the Pi 

Make sure your Raspberry Pi is turned off and unplugged 
before you do this. Using the three male-to-male 
jumper wires, connect the ground to the two LEDs, the 
buzzer, and the LDR as shown in the diagram. Next, use 
the remaining male-to-female jumper wires to connect 
the breadboard to the Raspberry Pi’s GPIO pins. 


>STEP-04 

Install the software 

Turn on your Raspberry Pi, and ensure it is connected 
to the internet. Using the Terminal, clone the GitHub 
repository containing the code to your Pi’s SD card 
using the command: 


* 
* ss 
- # 
* . 
* Pa 
ee 
ss . 
- # # 
* es @ 
* 6 6 
ses @ 
* ee 
* 6 
* 6 
. 
id 
Ld] 
. 
. 
* 
ss se 6 6 
ss &# 8 6 
ss ses 68 6 
s- ¢# &# @& 6 
se #8 #8 6 
*ese sees 


git clone https://github.com/henrybudden/ 
rpesk-advanced/ 


Once the files have downloaded and you have 
returned to the command prompt, change into the 
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Sunrise_alarm.py 


from Tkinter import * 
import RP1i.GPIO as GPIO 
import time, math 


GPIO.cleanup() 


GPIO.setmode(GPIO.BCM) 


sunrise = 50 
a pin = 18 
b pin = 23 


buzzer_pin = 24 
red_pini = 27 
red_pin2 = 22 


GPIO.setup(buzzer_pin, GPIO.OUT) 
GPIO.setup(red pini, GPIO.OUT) 
GPIO.setup(red pin2, GPIO.OUT) 


def discharge(): 
GPIO.setup(a pin, GPIO.IN) 
GPIO.setup(b pin, GPIO.OUT) 
GPIO.output(b pin, False) 
time.sleep(@.01) 


def charge time(): 
GPIO.setup(b pin, GPIO.IN) 
GPIO.setup(a pin, GPIO.OUT) 
GPIO.output(a_pin, True) 
t1 = time.time() 
while not GPIO.input(b_ pin): 

pass 

t2 = time.time() 
return (t2 - t1) * 100e@000 


def analog read(): 
discharge() 
return charge time() 


directory containing the code by using the command 


cd rpesk-advanced. 


>STEP-05 

Run the code 

The time has come to run the code and test out the 
alarm! After checking that the circuit you have built 
is an exact replica of the one shown in the circuit 
diagram, and that it is connected to the Pi, run the 


DIY SUNRISE ALARM 


def read _resistance(): >PYTHON 2 
n = 20 
total = Q; DOWNLOAD: 


magpi.cc/2eCbCtZ 


for i in range(1, n): 


total = total + analog read() 
reading = total / float(n) 
resistance = reading * 6.05 - 939 


return resistance 


def light_from_r(R): 


return math.1log(10@0000.0/R) * 10.0 


while True: 


GPIO.output(red_ pini, False) 
GPIO.output(red pin2, False) 


light = light_from_r(read_resistance()) 
print light 
X = @ 


if light > sunrise: 
GPIO.output(red_pini, True) 
GPIO.output(red_pin2, False) 
while True: 
Xx =xX+1 
GPIO.output(buzzer_pin, True) 
time.sleep(@.001) 
GPIO.output(buzzer_pin, False) 
time.sleep(@.001) 
1 Xo —— 250. 
X = @ 
break 
GPIO.output(red_pin1, False) 
GPIO.output(red_ pin2, True) 
while True: 
X= x + 1 
GPIO.output(buzzer_pin, True) 
time.sleep(@.001) 
GP1IO.output(buzzer_pin, False) 
time.sleep(@.001) 
if x == 250: 
X = @ 
break 


>STEP-06 

Make it your own 

The default threshold for the alarm’s activation is 
when the photoresistor reaches a value of 50, which 
works well for testing as described previously. 
However, in order to use the alarm to accurately 
detect the sunrise in the morning, this value can 

be changed by entering the file editor with the 
command nano @1_ sunrise _alarm.py and then 


command sudo python 01 _ sunrise_alarm.py. You 
can test that the alarm works by shining a torch at the 
photoresistor from within a fairly light room. The LEDs 
should start to flash, and the buzzer should sound. If 
this happens, congratulations! 
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changing the value found on line 13. We would 
recommend that you use 30 for fairly accurate 
detection of dawn. Save this change by pressing 
CTRL+X, followed by Y, then the ENTER key. This 
code can now be run again as in step 05. 
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microSD card 
USB stick 


Wired Xbox 360 
controller 


Amiga Kickstart 
ROMs 
amigaforever.com 


Amibian 
bit.ly/Amibian 


(&) Paths 
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g ROM 
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== Floppy drives 
& Hard drives / CD 
® Display 
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Reset (Quit 


You can load and create 
emulated hardware 
configurations for specific 


TURN YOUR PI 
INTO AN AMIGA 


Recapture the glory days of 16-bit computing by turning your Pi 


into a faithful Amiga emulator 


he Commodore Amiga’s top-notch sound and 
eraphics made it one of the most desirable 
home computers of the ’80s and early ’90s, 
at a time when your average IBM PC was still plodding 
along with EGA graphics and an internal beeper. 
Amiga games from the era have aged incredibly well, 
and look and play brilliantly on everything froma 
portable display to a widescreen TV. We’|l take you 
through turning your Raspberry Pi 3 into a perfect 
modern-day Amiga emulator. You’1l need a Windows, 
Mac OS X, or Linux desktop operating system to 

copy the Amibian Linux distribution to your SD card 
and unpack the Kickstart ROMs required to make 

it work smoothly. 

Start by downloading the Amibian distro. Format a 
microSD card, decompress the Amibian RAR file, and 
use Win32DiskImager or Linux’s dd command to copy 
the IMG file to the card. A 4GB card should be plenty, 
as Amibian only occupies around 300MB. 


\/ DFO: 3.5" DD ~ \Y Write-protected Eject a 
Ww 

| Load config with same name as disk 

| DF1: Disabled w | Write-protected Eject x 
Ww 

[ DF: Disabled w lV Write-protected Eject - 
Ww 

[ DFS: Disabled w \/ Write-protected Eject 2 
Ww 

Floppy Drive Emulation Speed: 100% (compatible) 


Save contig for disk Create 3.5" OD disk Create 3.5" HD disk 


Start 


Once you've set up your 
emulated hardware 
and firmware config, 
just mount a floppy disk 
image and click Start 


Game controllers, 
mouse, and keyboard 
configurations can 

be selected and 
tweaked in Input 


Amiga computers 
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Slot the microSD card into your Pi and power up. It’1l 
boot directly into the UAE4ARM emulator, but there’s 
some extra configuration to do before we start playing. 
Quit UAE4ARM to get to the command line and run: 


raspi-config 


Select Expand Filesystem, which will give you access 
to the entirety of the SD card’s capacity for storage, 
then Exit and select Yes to reboot. 

If your Pi won’t output sound via HDMI properly, 
enter this at the command line: 


nano /boot/config. txt 


Make sure the following lines are present and aren’t 
commented out with a preceding hash (#): 


hdmi_drive=1 
hdmi_force_hotplug=1 
hdmi_force_edid_ audio=1 


Save and return to raspi-config: 
raspi-config 


Select Advanced Options > Audio > Force HDMI 
and then reboot. 


Kickstart me up 

To run Amiga programs, you’ll need a Kickstart ROM 
— firmware from the original computers. VAE4ARM 
comes with the open-source AROS ROM, which can 
run only some Amiga programs, so we recommend 
using genuine Amiga Kickstarts for reliability. 

The Amiga’s Kickstart ROMs and Workbench GUI 
are still being maintained, thanks to Italian firm 
Cloanto. Amiga Forever Plus Edition, priced at €29.95, 
gets you a complete, legal set of Kickstarts for every 
Amiga computer and console. Cloanto is still working 


raspberrypi.org/magpi 


on a Raspberry Pi edition, so you’|l currently have to 
install Amiga Forever on a Windows PC or Wine and 
copy the files onto a USB stick. 

There are other ways of obtaining Kickstart ROMs, 
but most are legal grey areas. You can extract them 
from an Amiga using a tool such as TransRom or 
find them on abandonware sites, but we strongly 
recommend supporting Cloanto’s continued 
development of Amiga Forever. 

Classic Amiga software is even easier to find. You’ ll 
get 50 games with Amiga Forever Plus, while some 
major publishers have made the Amiga versions of 
their games available for free (see above). 

Many more games are only available online as legally 
dubious abandonware. They’re easily found using any 
search engine, but inform yourself of the legal status of 
such software in your region before you download. 


One true path 
As Amibian doesn’t include a window manager, it’s easiest 
to download and copy everything to a USB stick using your 
operating system of choice. Helpfully, UAEZARM can read 
Amiga ADF floppy images even if they’re in a ZIP file. 

We recommend copying everything to your microSD 
card. Fire up your Pi, exit VAE4ARM, and run: 


mc 


Copy your game files from /media/usb to 
/root/amiga/floppys, and your Kickstart ROMs, 
including a Cloanto rom.key file if you have one, to 
/root/amiga/kickstarts. Quit Midnight Commander 
and reboot: 


reboot 


In the latest version 1.313 of Amibian, two different 
versions of UAE4ARM are supplied. If you plan on using 
two Xbox 360 controllers, button mapping on controller 
two works best using the ‘old’ version, although the 
‘new’ edition generally provides more options. To 
switch between the two, at the command line type 
either rpiold or rpinew. The following configuration 
instructions work with both versions. 
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PUBLISHER-APPROVED 
GAME DOWNLOADS 


Amigaland 
amigaland.de 


Ami Sector One 
magpi.cc/2dDLElLL 


Dream17 
dream17.info 


Games Coffer 
gamescoffer.co.uk 


Gremlin Graphics World 
magpi.cc/2dDKZ3S 


Configure UAEZARM 
First, go to the Paths tab and click Rescan ROMs 
so UAE4ARM knows where to find everything. 

The Configurations tab lets you select from several 
preset hardware emulations, with the default being an 
A1200 - just select and Load your chosen computer. 
You can tweak your virtual hardware in the CPU and 
FPU, Chipset, and RAM tabs. 

Your configuration selection doesn’t always set the 
relevant Kickstart ROM for you, so check the ROM 
tab, where you can choose Kickstarts from a pull- 
down menu. Note that many games require a specific 
ROM or hardware configuration to work properly, 
depending on which system they were originally 
released for. 

To run most software, you’1l need the Floppy drives 
tab. Just press the ... icon next to drive DFo’s Eject 
button, select the desired disk image, and click Start. 

By default only drive DFo is active, and most 
titles expect this configuration. To swap disks 
when prompted, press F12, eject the disk image 
in DFo, select the disk image you’ re asked for, 
and click Resume. 

F12 will always pause and return you to UAE4ARM’s 
main interface, so you can create a Save state - a 
stored image of your progress in a game — or give up 
and load something new. The Reset, Quit, and Start/ 
Resume buttons are always visible in UAE4ARM’s GUI. 
Reset completely reboots your emulation and Resume 
returns you to your current game. 

UAE4ARM automatically detects Xbox controllers. 
You can use two controllers for multiplayer gaming 
- if the second is unresponsive, you may need to 
press F11 to disable your mouse and switch control 
to the pad. If you’re running the ‘new’ version of the 
emulator, first select your controllers from the pull- 
down Porto and Port1 menus in the Input settings. 

Now you’ve got your Amiga emulator up and 
running, there’s plenty of scope to build on the 
project, from setting up virtual hard disks to 
install Workbench and other software onto, to 
creating floppy images from your own original 
Amiga disks and using the Pi’s GPIO to connect 
a Classic ’80s joystick. 
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PARALLEL PROGRAMMING 


Put all four cores in your Raspberry Pi to work by running tasks in parallel 


Fig 1 
BREAKFAST 
LIST 


Boil kettle 
Make tea 
Pour tea 

Toast bread 
Butter toast 


Lay table 


Eat breakfast 


e are used to the idea that the Raspberry Pi 
has revolutionised education and the maker 
community, but since the launch of the Pi 2 it 


has joined one of the biggest revolutions in the history 


of computing: the change from single-processor to 
multi-processor computers. This is fundamentally 
changing the way we think about writing programs. 
The Pi 2 and Pi 3 both contain quad-core processors, 
which means that they can run four tasks 
simultaneously. In principle, this gives us four times 
the original speed, but in practice it can be difficult 
to make use of this extra power. In this article, we 
introduce one of the simplest approaches to parallel 
programming that will enable you to make use of all 
the processing power on your Pi. 


Three-core breakfast 

Before we write any programs, let’s look at something 
that most of us do every day: make breakfast. If we try 
to describe this in what might seem the obvious way 

— a list of instructions — it might look something like 
the list in Fig 1. 


Fig2 BREAKFAST TASK 
DEPENDENCY GRAPH 


Boil kettle | Toast bread Lay table 


Make tea Butter toast 


Pour tea 


Eat breakfast 
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The breakfast list is a sequential program. It contains 
all the instructions necessary to make breakfast, but 
something important is missing. In reality, we would 
never perform these tasks in sequence — we would do 
some of them in parallel. After all, it’s possible to boil 
the kettle and toast a slice of bread at the same time. 
But not all the tasks can be performed simultaneously 
— you can’t make the tea until the kettle has boiled. 
How can we describe this? One way to do it is with 
a task dependency graph. Each task in the graph 
can only start once all the others it depends on have 
been completed. The breakfast task dependency 
eraph (Fig 2) is amuch more useful description than 
the sequential program; it’s no coincidence that it 
describes more closely what we actually do when 
making breakfast, starting with all the tasks at the top 
of the graph and working our way down. As each of 
the initial tasks is completed, we can move on to the 
ones lower down that depend on it: once the kettle has 
boiled, we make the tea. Of course, not all programs 
that we’d like to run in parallel can be broken down in 
this way, but a task dependency graph offers a simple 
and powerful way to solve many problems in parallel. 


Meet your maker 

So how can we apply this to the Raspberry Pi 2 or 3° 
Raspbian contains a utility called Make, which follows 
a task dependency graph, executing tasks in the 
appropriate order and, where possible, running them 
in parallel using all four of the cores on your Pi. Make 
was designed to build programs in languages like 

C or C++ that require source code to be compiled to 
binary object files, executable programs, and libraries. 
However, it can be used to solve any problem that 

can be expressed as a Set of tasks with dependencies. 
To use Make, we need to write a ‘makefile’ which 
describes how each task depends on the others. As 

an example, we will generate a collage of thumbnail 
images from a set of original image files. This is 

often required when dealing with large numbers of 
image files, for example when managing photos on 
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a server. As well as running Make, we’re going to use Makefile 


ImageMagick for the image conversion, so ensure that 
both packages are installed on your Pi by running: 

# Thumbnail size in pixels DOWNLOAD: 
sudo apt-get update SIZE = 128x128 magPlcc72DSasJG 
sudo apt-get install make imagemagick 


# The list of original photos to use (fullsize/* refers to all files 


We’re going to use Make first to create a thumbnail # in the directory fullsize) 
image for each of the originals, then finally combine ORIGINALS = $(wildcard fullsize/*) 
them all in the collage. The majority of the work is in 
the generation of the thumbnails. The dependency # Use the list of originals to build a list of thumbnails (this takes 
eraph (Fig 3) shows the relationship between # the list of originals and changes the prefix on each file from 
each original image, its thumbnail, and the final # ‘fullsize’ to 'thumbs') 
collage. Since each thumbnail can be generated THUMBS = $(ORIGINALS: fullsize/%=thumbs/%) 
independently, we can put all four of our cores to work 
generating thumbnails, then finally create the collage # RULE 1: Generate each thumbnail from its original using the convert 
once they’re all ready. # utility from ImageMagick, rotating the image if necessary 

thumbs/% : fullsize/% 

Makefile rules ____ convert $< -thumbnail $(SIZE) -auto-orient $@ 
The makefile is all we need to describe our tasks and 
their dependencies. First, it defines the lists of original # RULE 2: Combine all the thumbnails into the montage and display it 
image files and thumbnails that we’re going to work montage. jpeg: $ (THUMBS) 
with. Then we define the two dependency rules in ____ montage $(THUMBS) montage. jpeg 
the graph. The first rule describes how to generate ____ display montage.jpeg & 
a thumbnail from a full-size image. It says that any 
file in the fullsize directory should be converted to # Clean up all thumbnails and delete the montage 
a thumbnail with the same name in the thumbs clean: 
directory, using the convert command. Note that the ____$(RM) thumbs/* montage. jpeg 


lines containing commands in a makefile must begin 


with a tab character (not spaces), shown in the listing Figs 
as a long underscore. Our second rule specifies that the 93 COLLAGE DEPENDENCY GRAPH 


final collage depends on all the thumbnail images. It Fea ea a a ” 

uses the montage command to create the collage and 
then displays it. Notice that we’ve told Make which 4 
commands will be used to rescale and combine the — inal ° 

images, but we’ve not specified an execution order. Fee se . 

Make will work this out for itself. We have moved away Thumb 01 Thumb 02 Thumb 03 
from writing a sequential program to describing a set q 4 
of tasks and their dependencies, allowing the system to Niners 5 neiaiilld ‘ 

work out how to solve them most efficiently. 


The simplest way to run our program is to type: 


Collage go  (------ 
make 


This will launch Make, which will read the rules of the existing pictures and rerun Make. It will now 
we have specified in the makefile and get to work do only the work necessary to update your collage. 
launching the tasks required in the correct order. Because Make understands the dependency graph and 
However, by default Make assumes that only one can see the date stamps on all the files in the graph, it 
core is available, so it will run each task sequentially. can work out exactly which tasks are required and will 
Luckily, we can easily tell it to use multiple cores: not redo any work unnecessarily. This also means that 

you can stop it in the middle of a job and it will pick 
make -j4 up the unfinished tasks correctly the next time you 


run it. Typing: 
This command specifies that Make should execute 


up to four jobs simultaneously, and your thumbnails make clean 

and collage will be generated up to four times faster 

than ona single core. Now try adding some new ...will clean up by deleting the generated 
pictures to the fullsize directory or updating some thumbnails and collage. 


raspberrypi.org/magpi December 2016 MagPi | 51 


Tutorial WALKTHROUGH 


>» ay » > \ 
Ne : i + ‘ 
a 
— " - ; \ 
Lon iy : . 


, ‘aaa <UL Pen aten u 
ay) esate me iS ae 


vw oe es = 
ese wc Lit 


re lr= |e ir Pay 


USB hard disk attached to 
Raspberry Pi 2 with multiple 
operating systems 


Use this like any normal 
multi-booting PC setup 


MULTI-BOOT YOUR 
RASPBERRY PI 2 


Use ‘Das U-Boot’ to boot multiple Raspberry Pi operating systems 


62 


from a USB hard drive 


ave your ever run different operating systems 
on your Raspberry Pie Did you ever wonder 
about a bootloader for the Raspberry Pi? Did 
you ever think of having your root partition(s) on a USB 
hard drivee Here is a guide for all these ideas. 

Over time, you might have collected a few Raspberry 
Pi 2 operating systems on various micro SD cards. 
Whenever you want to change to a different operating 
system, you might have to find the correct micro SD 
card, take out the current one, and put the new one in. 
This can be a fiddly job. 

Using a USB hard drive and multiple operating 
system images, we can create a multi-boot device, 
much like on a normal PC. 

For this we’re going to be using Das U-Boot, which 
you can read up on here: magpi.cc/2gaabm6. This 
method will also work on other Pi models, but some 
of the FDT and kernel files will be different. 


Get U-Boot working 

All the compilation work has been done on Ubuntu 
MATE 16.04, but any Linux system should be fine for 
the job. You could install the source of Das U-Boot on 
the Pi itself and do the compiling there, but it would 
take a while. 
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First, download Das U-Boot in the terminal with: 


git clone git://git.denx.de/u-boot.git 
--depth=1 


Next, install the cross compiler and tools: 
sudo apt-get install gcc-arm-linux-gnueabihf bc 


You’ll need to set the essential environment 
variables on the PC: 


export ARCH=arm 
export CROSS COMPILE=arm-1linux-gnueabihf - 


Move to the U-Boot directory (u-boot) with cd and 
compile with: 


make rpi_2_defconfig 
make allt 


From the result we need exactly one file, called 
u-boot.bin, in the main directory. Copy this 
file to the boot partition of your micro SD card 
(/dev/mmcblkop1) and modify config.txt in your boot 
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partition so it says kernel=u-boot.bin, or add the 
line if it’s not there. 

You’re now ready to test your changes on the 
Pi 2. The webpages indicate that you need a serial 
console, but some modern U-Boots happily handle 
USB keyboards. Follow the instructions on your HDMI 
screen or your serial console. Interrupt the boot 
process of Das U-Boot when you’re told to do so. You 
have two seconds to react, so be quick! 

Type in this sequence of U-Boot commands: 


setenv machid @x@0000c42 
fatload mmc @:1 ${fdt_addr_r} bcm2709-rpi-2-b.dtb 
fatload mmc @:1 ${kernel_addr_r} kernel7.img 


Set the boot args: 


setenv bootargs "bcm2708_ fb. fbwidth=1920 
bcm2708_fb.fbheight=1080 bcm2708 fb. fbdepth=32 
bcm2708_fb.fbswap=1 dwc_otg.lpm_enable=@ 
earlyprintk console=tty1 console=ttyAMA@, 115200 
rootfstype=ext4 elevator=deadline rootwait 
rootdelay=5 noinitrd root=/dev/ mmcblk@p2 
smsc95xx.macaddr=AA:BB:CC:DD:EE:FF" 


For manual booting, use the following: 


setenv bootargs rootwait noinitrd rootdelay= 5 
root=/dev/mmcbl1k@p2 

bootz ${kernel_addr_r} - ${fdt_addr_r} 

Saveenv 


Here’s what the relevant terms mean: 


machid 
is the U-Boot ID for the Raspberry Pi 2 fatload. 


bcm2709-rpi-2-b.dtb 
loads a flattened Device Tree file into memory. 


fatload .. kernel7.img 
loads the kernel into memory. 


“bootargs" 

is the U-Boot variable which contains the parameter string 
that’s handed over to the kernel; you find this under normal 
circumstances in cmdline.txt. 


Please note that we have to specify the fbwidth=1920 
and fbheight=1080 parameters, otherwise you’ ll 
see an HDMI display in a 800x480 configuration. 
The normal Raspberry Pi 2 boot process works this 
out automatically, but when using Das U-Boot, the 
information generated by start.elf gets lost. Currently 
there’s no easy way to recover this information 
successfully via Das U-Boot. 
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boot_via_uboot.ht = =§“wy 


>ASCII TEXT 


# boot script to generate boot.scr 
# this boot script will take the root device from the second 
partition of the micro SD card 


# machine ID 
setenv machid @x@0@000c42 


# load FDT 
fatload mmc @:1 ${fdt_addr_r} bcm2709-rpi-2-b.dtb 


# load kernel 
fatload mmc @:1 ${kernel_addr_r} kernel7.img 


# set the boot parameters 

setenv bootargs bcm2708 fb.fbwidth=1920 bcm2708_ fb. fbheight=1080 
bcm2708_fb.fbdepth=32 bcm2708_fb.fbswap=1 dwc_otg.lpm_enable=0 
earlyprintk console=tty1 console=ttyAMA@,115200 rootfstype=ext4 
elevator=deadline rootwait rootdelay=5 noinitrd root=/dev/mmcbl1k@p2 


# boot the kernel 
bootz ${kernel_addr_r} - ${fdt_addr_r} 


Boot up 
The Pi 2 should now boot into your favourite distribution. 
If it doesn’t, you can fix it by modifying /dev/mmcblkop1/ 
config.txt and commenting out the kernel= line witha 
leading #. When it’s working, you might get a slightly odd 
screen resolution. Let’s fix that. 

After the Pi 2 boots via Das U-Boot, you can 
automate the process by creating a boot_via_uboot.txt 
script file. This contains most of the commands you 
entered earlier and the full ‘bootargs’ parameter list: 


setenv machid 0x@0@000c42 

fatload mmc @:1 ${fdt_addr_r} bcm2709-rpi-2-b.dtb 

fatload mmc @:1 ${kernel_addr_r} kernel7.img 

setenv bootargs "bcm2708_fb.fbwidth=1920 bcm2708_ fb. fbheight=1080 
bcm2708_fb.fbdepth=32 bcm2708_fb.fbswap=1 dwc_otg.lpm_enable=@ 
earlyprintk console=tty1 console=ttyAMA@,115200 rootfstype=ext4 
elevator=deadline rootwait rootdelay=5 noinitrd root=/dev/mmcbl1k@p2" 
bootz ${kernel_addr_r} - ${fdt_addr_r} 

# generate with ./tools/mkimage -O linux -A arm -T script -n "boot 
schript for booting from usb hard disk" -d boot_via_uboot.txt boot1.scr 


This file gets converted by the tool mkimage into a 
U-Boot executable script file. The exact command is: 


./tools/mkimage -O linux -A arm -T script -n "boot script for booting 
from micro SD card via u-boot" -d boot_via_uboot.txt boot.scr . 


Copy the file boot.scr to the first partition of your 
micro SD card and test again. The system should 
automatically boot from the micro SD card. 

Next time, we’ll add partition scanning and create 
a boot menu you can use for true multi-booting! 
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YOUR QUESTIONS ANSWERED 
NEED A 
PROBLEM 


FREQUENTLY ggteita 
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to feature in a future issue. 


Your technical hardware and software problems solved... 4A 


Power pins 

Throughout the 40 pins, there are a handful that 
provide power (5V or 3.3V) and a few more that can be 
use as aground pin. Many of the individual pins can 
be programmed to output 3.3V. 

GPIO 

The vast majority of the pins are programmable ina 


number of ways. Most often you’ ll see them used to 
power simple components such as LEDs and buzzers, 
as well as sense when a button has been pressed. 


Physical computing Special functions 
The GPIO pins are used to connect to the ‘real world: Some pins have extra functions, such as providing an 
components such as sensors, lights, and buzzers. SPI interface, access to I?C, and more. These are used 
These can then be programmed and controlled via in more advanced projects, and you’1l usually be told 
the Raspberry Pi using built-in software. which pins to use and why they need to be used. For 
example, some chips need specific wiring to the GPIO. 
Add-ons 
The GPIO pins are also used to add functionality to the 
Raspberry Pi. Early on, LCD screens were a popular |HOW MANY PINS ARETHERE? = 
addition that connected via the GPIO. These days, HATs 
with many functions are available to add to the Pi. Original models 
The original Raspberry Pis had 26 GPIO pins running 
Minor hacks down the side. This included all the power pins, some 
As well as physical computing, the GPIO pins act eround pins, and a number of programmable pins. 
popularly as extra inputs. People add controllers to You’ ll see a few add-ons for Pi still only using 26 pins 
retro gaming projects through them. You can even so that they’re backwards compatible. 
power the Pi through the GPIO, allowing you to save 
some space on a bulky USB cable. B+ and beyond 


Raspberry Pis now have a standard 40-pin 
arrangement. You’ll find it on everything from the 

Pi Zero to the Pi3. The first 26 pins use the same 
configuration as the original Pi so that old projects still 
work, but the 14 extra pins add more ground pins and 
programmable pins. 


Compute Module 

For some serious computer projects, the Compute 
Module is designed with real products in mind. The I/O 
board has 200 GPIO pins, as it’s expected to do a little 
more than learning how to light LEDs with GPIO Zero! 


Right The Pi 

Zero features an 
unpopulated GPIO 
by default - you 
can add a header 
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How powerful is the Raspberry Pi? 

Real-world performance for models A, A+, B, and B+ 

is akin to a 300MHz Pentium 2, only with much better 
graphics — the GPU is capable of 1Gpixel/s, 1.5Gtexel/s or 
24 GFLOPs of general-purpose computing, and includes 
texture filtering and DMA infrastructure. The Model 2B is 
approximately equivalent to an Athlon Thunderbird running 
at 1.1GHz, but with higher-quality graphics thanks to the 
same GPU. The Model 3B is around 50% faster than the 2B. 


Can it be overclocked? 

Pi models A, A+, B, and B+ operate at 7OOMHz by default; 
most devices will run happily at 800MHz. The Model 2B 
operates at QOOMHz by default and should run quite happily 
at 1000MHz. In the latest Raspbian distro, there's an option 
to change the overclocking options on first boot and at any 
time afterwards, without voiding your warranty, by running 
sudo raspi-config. It should be noted, however, that 


YOUR QUESTIONS ANSWERED 


these are experimental settings and that not every board will be 
able to run stably at the highest setting. If you experience problems, 
try reducing the overclocking settings until stability is restored. 


Do you need a heatsink? 

You shouldn't need to use a heatsink, as the chip used in the 
Raspberry Pi is equivalent to that in a mobile phone, and should 
not become hot enough to need any special cooling. However, 
depending on the case you're using and the overclocking settings, 
you might find a heatsink to be advantageous. We recommend the 
use of a heatsink if overclocking the Model 3B. 


What hardware interfaces does it have? 

Depending on the model, the Raspberry Pi has either 40 or 26 
dedicated GPIO pins. In all cases, these include a UART, an I?C bus, 
an SPI bus with two chip selects, I?S audio, 3V3, 5V, and ground. 
The maximum number of GPIOs can theoretically be indefinitely 
expanded by making use of the I?C or SPI bus. 


WD PIDRIVE 
FOUNDATION 


PBERRY PI 


pitta USB AUNGTICH any and an SD card p 
ers , the WD PiDrive Foundation Edition 
is your aks storage solution for Raspberry Pi. Start creating 


projects in a matter of moments. 


© wDLasBs 


wdlabs.wd.com/holiday 
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ss THE ' Official Raspberry Pi 
RASPBERRY PI 


PROJECTS BOOK 


VOLUME 2 


Amazing hacking and making projects 
from the creators of MdgPi magazine 
Inside: 

How to get started with Raspberry Pi 
The most inspirational community projects 
Essential tutorials, guides, and ideas 
Expert reviews and buying advice 


ailable 
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IN 


ow for the cool stuff: your Raspberry Pi 
robot can be a lot more than just a remote- 
controlled device. By using sensors, we 
can make your robot react to its environment. We 
also need to use sensors for the robot to be able 

to compete in Pi Wars autonomous challenges. In 
this feature we’re covering the ever-popular line- 
following course, maze solving, and the straight- 
line robot drag race. The sensors we will be using 
are line-following and distance (range) sensors. 
We’ll also take a look at alternative sensors you 
could add instead of the ones we’ve selected to use 
for the challenges. 
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CHALLENGE: 


LINE FOLLOWER 


This challenge is a favourite with many robot competitions. 
With great programming, amazing times can be achieved 


he classic line-following challenge has 
been around for as long as people have been 
making robots and holding competitions. In 


this challenge, you must complete three laps around 
a circuit as fast as possible. The line will normally 
be black on a white background. 

There are several methods used to sense the 
line. Infrared (IR) LEDs, the most common way to 


LINE 
SENSOR 


This Ryanteck line follower is 
the one we will be using. On the 
top side, you can see the three 
LEDs corresponding to the three 
sensors underneath the PCB. The 
adjustable resistor, commonly 
known as a pot, is for adjusting 
the sensitivity. 
magpi.cc/2eoEXTL 
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THINGS TO CONSIDER 


achieve this, use a light source and measure the 

light reflecting back. This works because the black 
line does not reflect as much light as the white 
background. The line-following sensor we have 
selected uses this method. The sensor has an array of 
three paired IR LED and photosensitive diodes; each 
pair of diodes is associated with an input pin on the 
Raspberry Pi. 


NOT ALL LINES ARE THE SAME! 

The line in a line-following contest can be produced by 
several methods. This means it may be invisible to your 
sensor, aS some inks can be transparent to IR light. 
Common methods are laser, ink, and electrical tape. 
Test your robot with different types of lines! 


LET THERE BE LIGHT 


HIGHER, LOWER 

The height at which the sensor is mounted can affect 
how well your sensor works. If you found your sensor 
is unreliable, it may be mounted too high or low. Try 

lowering the sensor if it’s mounted high or raising if 

mounted low; repeat until you find the sweet spot. 


FASTER IS NOT BETTER! 
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Testing the sensor 
Now to test the sensor: power up 
your robot and place it on a white 
surface. The LEDs on the sensor 
will light. Now place it on a black 
line. Each time the following 
sensor goes over the line, the large 
LED corresponding to it should be 
unlit. If you’ve not done so already, 
download the code and test. If the 
line is on the left, the robot should 
turn to the right; if in the middle, 
the robot should move in a straight 
line; if on the right, it’ll turn left. 


Raspberry Pi GPIO BCM numbering 


18 23 8624 25 
PMO 
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9) GCLK1 GCLK2 PWM1 
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Connect the sensor to the GPIO pins 

For connecting the sensor to the Pi, you’1l need 
‘ five male-to-male jumpers. The robot should be 
powered down while connecting them. With the Pi 
Zero’s USB ports towards you, count five pins from 
the left: this pin is GND (OV). The next three pins 
will be associated with the three output pins on the 
sensor, and the next pin is 3V3. Connect the jumpers 
to the corresponding pins on the sensor. See the 
table for assignments. Be careful connecting to the 
GPIO pins: double-check each one. 


The maze challenge is another classic and 


on YouTube for some 


his is a classic challenge, and very popular. The 
idea is to solve the maze in the quickest time 
possible; in the Pi Wars version, we are not 
allowed to touch the walls. For the challenge, we’ve 
selected a ToF distance sensor. The ToF (time-of-flight) 
sensor is an advanced version of the IR (infrared) 
distance sensor, which measures the intensity of the 
returning IR light. However, it’s possible for the ambient 
light and the colour of the surface to affect readings 
from the sensors. ToF sensors were developed to counter 
those issues. They work by sending out pulsed light 

and count the time it takes for the light to return; this 
counters the effects of the colour of the surface and 
ambient light. Depending on how you approach this 
challenge, you may need to use more than one sensor. 
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MAZE 


maze-solving robots are amazing — have a look 


The time-of-flight sensor is the new 
kid on the block. The one we have 
selected uses IC to talk to the Pi Zero 
and returns the distance in millimetres! 


OTHER SENSORS 


4 a ) 


The Raspberry Pi Camera Module ®: 
can be used to navigate the maze, 
using computer vision techniques 
to find the walls or just working out 
which wall your robot is pointing 
at. The Python library you need for 
computer vision is OpenCV - or, if 
you find OpenCV overwhelming, 
there is SimpleCV. Think of 
SimpleCV as the CV version of 
GPIO' Zero. 


” 
A 


HULU 


LIDAR 


The ultrasonic sensor uses 
sound to find the distance 
to an object, the same way 
as a bat does. They work by 
measuring how long a pulse 
of sound takes to return to it. A 
benefit of using this sensor is that 
it’s not affected by ambient light. However, it’s affected 
by how dense the target object is, and the sensor has a 
wide target area which can lead to ghosting. 
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Solder the I?€ expansion header 

Solder a right-angled header to the expansion 
port on the ZeroBorg. The expansion port is next 
to the DC-to-DC converter; the header should 
be on the top of the board and the pins need to 
face the outside of the board. 


3V3 Vin 

GND GND 
SDA (BCM 2) SDA 
SCL (BCM 3) SCL 


maze.py 


@1 
@2 
@3 


04. 
@5 
06 


Q7 
08 


@9 
10 
11 
12 
13 


Note: This is pseudocode for 


explanatory purposes - the full 
version is in the GitHub repo. 


Defines a list of the required 
moves for the maze. 


Function for setting the motors for each 
type of move; for the turns, the robot will 
spin on the spot. 


The for loop reads each item of the move 
list and passes them to the function ‘turn’ 


STRAIGHI-L 
SPEED TES | 


The smell of burning rubber and screaming motors is autonomous robot drag racing. 
How fast can your robot cover seven metres in a straight line without hitting the wall: 
we like to call it, robot drag racing — is torun 


Ty the course as quickly as possible, and it’s run 


autonomously. If you can afford it, it’s best to use two 
sensors for both sides of the robot, and you may also 
want to change the motors to a lower ratio for more 
speed; 20:1 or 10:1 motors are available. The size of the 
wheels can also affect the speed and acceleration of 
your robot: small wheels are the quickest to accelerate 
while larger wheels have a higher top speed. 


he aim of the straight-line speed test — or, as 


One or more distance sensors are mounted to 

the robot, facing the course wall(s). The robot is 
programmed to stay at a set distance from the wall(s) 
and if the robot gets too close to a wall, it’s instructed 


7 We're using the same Pololu ToF to turn in the opposite direction. When only one 
sensor we used in the Maze challenge. sensor is used, the robot turns back toward the wall 
The sensor is mounted at the front after a set time to ensure it doesn’t hit the far wall. 


of the robot, pointing to the side, and 
needs to be below 40mm. 


MOTOR/WHEEL ENCODERS 


An IMU is a sensor that measures and reports a 
body’s specific force, angular rate, and sometimes 
the magnetic field surrounding the body, using a 
combination of accelerometers, gyroscopes, and 
magnetometers. This allows a bearing to be followed; 
you may want to add a means of aiming your robot 
before starting the challenge. 
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3V3 
GND 

SDA (BCM 2) 
SCL (BCM 3) 
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Wire up the sensor 

The sensor is a delicate piece of equipment, so you 
need to be careful when putting it on. You’1l need to 
turn the robot off before adding the sensor (although 
you should be doing this with any additions to the 
build). The layout of the pins is slightly different, 

so refer to the table below for what pins to wire up 

to the ZeroBorg. You won’t need two as in the maze 
challenge, although if you want to add a second one 
for more precise readings, look at that spread for more 
information on using two ToF sensors. 


GND 
SDA 


Note: This is pseudocode for 
explanatory purposes - the full 
version is in the GitHub repo. 


Starts the motors so the robot 
can move forward. 


The control loop. Runs as long the 
Raspberry Pi has power. 


Reads the sensor. 


This sets the direction 
the robot will turn. 


Adjusting this will affect 
how quickly the sensor is read. 


Maker 
days 


Connect 
your 
Raspberry 
Pi to the 
physical 


world 
Bare Conductive 


RASPIO 
PRO HAT 


Although it 
doesn't quite 
have as many 
functions as 
the Pi Cap, it’s 
stilla great 
prototyping 
board for the Pi. 


£15 / $19 


rasp.io/prohat 


A HAT that adds some interesting features to a Raspberry Pi. 


Just how well does it fit? 


are Conductive is one of 

those cool things we love 

to see stuff made with. 
The conductive paint can be used 
in some amazing creative builds 
and we love seeing people make 
things with it and post pictures 
and videos online. 

To expand the uses of the paint, 
Bare Conductive the company 
has created its own special HAT 
for the Raspberry Pi, called the 
Pi Cap. HAT, Cape The name isa 
bit more than just a pun, as one 
of the board’s most interesting 
features is the addition of 
capacitive touch buttons/pads. 
We’ll get to that, though - first, 
let’s talk about the design. 

The Pi Cap works very much 


4 like a standard HAT, sitting on 


top of your Raspberry Pi and 
eranting you immediate access to 
more functions through the use 
of special software. Unlike most 
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HATs, it hangs over the sides of 
the Raspberry Pi, though this is 

a deliberate design choice which 
allows easier access to some of 

its features. While it’s designed 
with the Pi Zero in mind (the parts 
of the board that don’t overhang 
fit snugly over the Zero’s form 
factor), it will work on any other Pi 
model with a 40-pin GPIO. 

The board comes pre-soldered 
So you can use it out of the box. 
You can put it straight ontoa 
Raspberry Pi from there, although 
this does require some degree of 
software setup. The process is 
well documented on the website 
(magpi.cc/2eKcB5C), and you 
should be able to get it all set up 
within half an hour. 


Internet of caps 

With the Pi Cap on and ready 

to use, you have access to the 
aforementioned capacitive touch 


pads. These are the large gold 
connectors on the long edge, 
which can also be used to connect 
to wires and which are ideal 
for painting on with the Bare 
Conductive paint. Next to these 
is a large prototyping area with 
a GPIO breakout. There’s also a 
physical button and an RGB LED 
attached to the board. 

It’s all really quite appealing. 
It adds a decent amount of useful 
functionality for education and for 
creating some interesting projects 
(you can find Capong in our last 
issue, but there are others on the 
firm’s website under Suggested 
Tutorials: magpi.cc/2eKcB5C). 
We especially like the little 
breakout area, which is useful 
in any project. However, the 
Capacitive pads are also excellent 
and the slightly larger holes in 
the connectors make them pretty 
eood for wearables as well. 
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Programming the Cap is pretty 
simple and you can do so ina 
number of languages, including 
the standard Python and C++, 
although you can also control it 
via Processing. Again, refer to our 
Capong tutorial from last issue 
for a sneak peek into how that 
works. There’s also an interactive 
introduction and examples that 
come with the code so you can try 
some lower-barrier-to-entry tests; 
they’re enough to get your head 
around what’s going on at least. 
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Thinking cap 

We do like the build of the Pi Cap. 
It’s very robust and high-quality, 
possibly even more sturdy than 
the Pis themselves, which is quite | 4 
the accomplishment. All the | Sty pone 
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It's very robust and high- 
quality, possibly even more 
sturdy than the Pis themselves 


components are very small and We’d love to see an activity 
have a very small form factor, kit come with the Pi Cap in the 
; ; . A neat little board with a lot of 
meaning you will be unlikely to future, with some components 
: potential, adding some fairly 
snap them off easily. There’s and perhaps a book to get you . 
ae meee eee nee at f ne unique features to the Pi. It 
even a high-quality au 10 jac started with some fun projec S. wouldibe betterinalit butibe 
installed on the board — it’s At the moment, though, it’s still : i: ; 
still great in its own right. 
perfect for the Pi Zero and isa a pretty great board on its own, 
little better than the 3.5mm jack and maybe something to look into wx ¥ ww > 4 
on the Pi 3 as well. with Christmas coming up. 
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Maker 
days y; 
The Four WP 

Star package J a 

offers —=— 


4 SREMeE* 
Increased Eee hag tae ie 
versatility 
Dremel 


es | OREMEL | Willi Nyy! 
PUL RURELILI TIPE! 


DREMEL 3000 


BLACK & 
DECKER 
WIZARD 
RT650KA 
KIT 


While it lacks 
some of the 
more advanced 
accessories, like 
the SpeedClic 
system and 
flexible shaft, 
the Wizard kit is 
a considerably 
cheaper 
introduction. 


Se 7! \ 


£35 / S65 
magpi.cc/2ghXtmn 
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FOUR SIAR KIT 


Can a toolbox and a selection of popular accessories 
renew interest in the Dremel 3000 rotary multitool? 


otary multitools are in 
the family of devices that 
you never really think 
you need, then once you have one 
wonder how you survived without. 
At their heart, they’re little more 
than a high-speed electric drill 
that you hold like a pencil; the 
wealth of accessories you can 
insert into the collet, though, 
enables them act like everything 
from routers and engravers to 
circular saws and polishers. 
Dremel’s latest attempt to turn 
people on to the joys of rotary 
multitools comes in the form of 
three new bundles, timed for pre- 
Christmas release. The Three Star 
Kit is a variant on the existing 
bundles, offering a Dremel 3000 
multitool, a small number of 
accessories, and a plastic desk 
holster for storage. The Four Star 
Kit, as reviewed, ups the ante to 
include a wider range of accessories 


and a plastic toolbox for storage. 
The Five Star Kit, meanwhile, 
tops the range out with a fuller 
accessory selection and a more 
robust aluminium toolbox. 

Unpacking the Four Star Kit 
reveals the first disappointment. 
The cardboard outer wrapping 
makes much of a bundled chess set, 
part of a competition run by Dremel 
encouraging users to make their 
own chess pieces using the included 
tool. The ‘set,’ though, is nothing 
more than a chess board printed 
on the reverse of the packaging 
and a set of black and white two- 
dimensional cardboard counters; 
this may be handy if you’ve 
forgotten what chess pieces look 
like, but it’s not something you’d 
want to use to play a game. 

The chess set is by-the-by, 
however. The kit’s real meat comes 
inside the plastic toolbox, the lid 
of which entirely detaches with 


a flick of the solid-feeling blue 
catches. A second disappointment 
awaits, though: the interior of the 
toolbox is entirely plain, devoid of 
any indentation or padding to hold 
the tool and accessories properly. 
While it’s certainly functional for 
storage, if you’re planning to use 
your Dremel on the road you can 
expect a great deal of rattling and 
crashing of loose parts. 
Thankfully, things improve from 
here on out. The kit includes many 
well-thought-out accessories: 
there’s the flexible shaft, which 
provides a smaller tool head for 
easier use while insulating the 
user from the heavy vibration of 
the tool’s motor at high speeds; 
there’s the line and circle cutter, 
satistfyingly robust; and what 
Dremel bills as a ‘multipurpose 
cutting kit’ which includes three 
milling bits, a plastic guard, anda 
euide with pre-measured adjustable 
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depth. All attach to the Dremel tool 
itself in moments and detach easily, 
though the flexible shaft does 
require replacement of the collet. 


Accessorise 
The remainder of the accessories, 
to make up the promised count of 
55 on the outside of the box, run 
the gamut from cutting discs and 
sanding drums to polishing tools 
with a small vial of compound 
to match. Most can be installed 
quickly using the pre-installed EZ 
Twist Nose Cap, which replaces 
the traditional wrench for most 
tool-change jobs. The exception, 
as always, is in the cutting and 
erinding discs, most of which must 
be carefully screwed on to the 
bundled mandrel using the back 
part of the wrench tool. 

Another notable accessory is 
a pair of discs designed around 
Dremel’s relatively new EZ 
SpeedClic system. These will 
come as arevelation to anyone 
who has dropped a mandrel screw 
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on the floor: each disc features a 
specially shaped and reinforced 
centre, which slots and locks onto 
a sprung mandrel. Discs can be 
swapped in seconds, rather than 
minutes, which is why it’s sucha 
shame Dremel only includes two 
SpeedcClic discs in the pack; the 
remainder are of the traditional, 
screw-fixed variety. 

In use, the Dremel 3000 - first 
released in 2011 as a replacement 
for the older Dremel 300, boasting 
improved cooling and better 
ergonomics — is a pleasure. The 
contours of the shape make it easy 
to hold, while the speed control 
— which adjusts from 5,000 to 
32,000 revolutions per minute — 
is responsive and accessible. At 
high speeds the Dremel vibrates 
heavily and makes an awful din; 
fortunately, the majority of tasks 
are better carried out at lower 
speeds anyway, and for those that 
aren’t, the Dremel can be hung 
from its metal loop and the flexible 
shaft can be used in its place. 


Mu 
tear ith Valve Kit — a Stag Epr 
Marae HiGh au Kt 4 sar eae 

Wah Value Kit - 4 sear st 


While the accessory choices may not be to 
everyone's taste, the Four Star Kit is a great 
introduction to the Dremel range at a reasonable 
price. A higher-quality toolbox would have been 


nice, though. 


KKK 
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Waker 
days 
Connect 


the two 
Included 


servo motors 


to your 
Raspberry Pi 


Monk Makes 


ADAFRUIT 
MINI PAN- 
TILT KIT 


Aservo kit 

with more of 

a purpose, 

this can be 
modified to any 
applicable use. 


£20 /$19 
magpi.cc/2eQBU6a 
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li £12 / $15 


monkmakes.com 


SERVO KIT 


A kit for starting out with simple robotics projects on your Raspberry Pi 


e see a lot of motor boards 
for the Raspberry Pi here 
at The MagPi, but very 

few servo controllers. On some 

level, they’re very similar: they 
drive an electronic motor that 

can be programmed by the Pi. 

The major difference is the power 
and accuracy of the components; 
motors tend to just spin, while you 
can tell a servo to turn a certain 
amount. The limitations of both 
types can be worked around with 

a good bit of code and know-how, 
but it’s best to use a dedicated 
driver for each. 

The Servo Kit we’re looking at here 
from Monk Makes comprises several 
parts, chief among them being the 
Servo Six board, a dedicated servo 
controller. The rest of the kit is 
a couple of simple servo motors, 
some jumper wires, and a battery 
case. It’s enough to get you playing 
around with servos, with room for 
improvement as you learn. 

It connects to the Raspberry Pi 
via seven pins (six GPIO and one 


GND). As it has so few connections, 
it doesn’t function as a HAT; 
instead, you’ ll be connecting it 
via the jumper cables. This is 
better for a lot of projects, as it 
means the rest of the GPIO pins 
are available for other bits. You’1l 
need to figure out a workaround if 
you do have a HAT as part of your 
project, though. 

Construction is simple: there’s 
no soldering involved, and there’s 
plenty of info on the Servo Six page 
(magpi.cc/2eXxxtr) and GitHub 
repo for putting together a simple 
little circuit and programming it. 
The code uses Python, as usual, 
and instead of the simple forward, 
left, right, and stop commands 
from other Monk Makes motor 
boards, this one works in angles. 
Setting angles will cause the servo 
to spin to what it defines as that 
angle, but it will require calibrating 
for your project, or at the very least 
some trial and error. You’|l have to 
make sure you understand which 
angle spins where, as well, when 


you want to move it ‘back’, and 
there are some little tricks you’ ll 
need to make use of to spin it in 
the correct direction sometimes. 
The Servo Six Board itself is 
pretty great, though. You can 
control six separate servos with 
it and the code to differentiate 
between them is as simple as 
using the correct number, from 
1 to 6, in the angle-changing code. 
With just the two servos included 
in the box, you’1] need to look at 
eetting more servos if you want to 
upgrade your projects, but it won’t 
require any extra connections to 
the Raspberry Pi. 


fast word 


A great little kit for learning 
how to use servos that also 
has room to grow into some 


excellent projects. It's very 
well priced too. 
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RASPBERRY SWEETS 


CAFFEINE 
FREE 


RASPBERRY 
SWEETS 


We head to our favourite sweet shop, Mr Humbug’s in Greenwich, 
and pick up a bagful of raspberry-flavoured sweets for Christmas 


FRUIT blue dye lying around and decided to _ sour, but not as bad as the Blue 4 Megas Sour 
ee ae, Pare use it for raspberry sweets. Razz Jawbreaker. We gamely give it a 
SOTSINeALICIOSe a go for 30 seconds before getting Ba) SAST BERRI | 
(naturally ; Food for thought heartburn and a headache. See you a) 
occurring Sugar). : 

Ublfeetene AurHeads Chew has the scrummy next year. 

sugar, fructose tagline, ‘Artificially Flavoured 

also contains Candy’. We check out the nutritional fast word 

vitamins, 


minerals, and 
nutrients. The 


t’s Christmas, and the 
team at MagPi Towers are 
benchmarking a lucky-dip 
mix of raspberry-flavoured sweets. 

First up had to be Nerds. A hit 
of pure sugar, followed by a fresh 
minty afterglow with a mild taste. 

It’s often said that a camel is 
a horse designed by committee. 
We’d love to meet the committee 
which was responsible for naming 
Hubba Bubba Bubble Tape Sour 
Blue Raspberry. It looks like blue 
Sellotape and tastes of absolutely 
nothing. We had fun blowing blue 
bubbles with it, though. 

According to MentalFloss 
(magpi.cc/2fqQ41X), sweet-makers 
of yore used a dark red dye called 
Amaranth E123 until the 1970s. But 
a Soviet study linked it to cancer and 
it was banned. They had lots of spare 


facts: 1% fat, 0% sodium, 5% carbs, 
and 0% protein. 


some scales. It’s a sobering sight. 
The soda tastes nice, though. 

Our high hopes for Swizzels 
Sherbet Dip Tangy Raspberry didn't 
go unrewarded. The pink stick says 
‘Luv U’ and ‘Hug Me’, a welcome 
change from the ’90s ‘Xtreme’ 
styling of other sweets. We dip and 
dab the old-fashioned way. Pure 
sugar with a tangy edge. 

In contrast, the Blue Razz 
Jawbreaker is the worst thing our 
reviewer has ever tasted. And she’s 
drunk fermented horse milk in 
France and eaten grits from a shack 
in Alabama that had ‘we got good 
eats’ painted on the side. We’re 
euessing kids gamble on who can 
mouth one the longest. 

We saved the Barnetts Mega 
Sours for last, as Mr Humbug had 
warned us about them. They’re 


Sherbet Dip is a sweet treat 


apical, ey 


6s aang, e FL 


i i a 


/, 


ic? eo? 
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NHS advises that Inside. the AirHeads Chew is a that takes us back toa | araeTs >. 
) eo oy E — Ss 
i eplecesor __Uvighter shade of neon blue than childhood where dabbing i HEAR — 
its metallic wrapper. It’s tough and had a different meaning. 


fruit a day. 


50p / $1 
magpi.cc/2exjThs 
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chewy. We suspect that it might be 
94% blue dye. Bleugh! 

To get rid of the taste, we crack 
open acan of Berry Fanta. Also 
blue. It contains 43g of sugar. In the 
interests of sclence, we measure 
out 43 grams of granulated sugar on 


Everything else was a bit too 
sour for our taste buds. The 
Blue Razz Jawbreaker was 
worth tasting just for the 
eye-watering experience. 
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RASPBERRY PI 
BESTSELLERS 


Don't settle for mediocre, bloated, and slow; 
find more effective ways to power the web! 


GO WEB 
PROGRAMMING 


Author: Sau Sheong Chang 
Publisher: Manning 

Price: £27.99 

ISBN: 978-1617292569 
magpi.cc/2foFFga 


From microservices to scalable, 
high performance web apps 

on multi-processor platforms, 
discover why Go's simplicity - 
its directness with HTTP - and 
standard library make for happy, 
productive programming. 


WEB 
DEVELOPMENT _— 
WITH CLOJURE » gay 


Authors: Dmitri Sotnikov 
Publisher: Pragmatic Bookshelf 
Price: £25.50 von es 
ISBN: 978-1680500820 
magpi.cc/2f0E835 


One of the best web dev 

books, updated. Build an app 
with the Ring/Compojure and 
Luminus framework, functional 
programming, and the flexible, 
replaceable components of the 
Clojure web stack. 


BEYOND JQUERY ~ 


Authors: Ray Nicholus ae 
Publisher: Apress 
Price: £27.99 

ISBN: 978-1484222348 
magpi.cc/2foxo6R 


The jQuery playpen is 

not just preventing you 
improving your coding, 

it's often an unnecessary 
dependence. Nicholus shows 
you a JavaScript-only way of 
working and lets you make 
your own decision. 
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MAKE: 


GETTING STARTED 
WITH RASPBERRY PI 


Author: Matt Richardson 

& Shawn Wallace 
Publisher: Maker Media, Inc 
Price: £14.50 
ISBN: 978-1680452464 
magpi.cc/2foL1kN 


There are many 
newbie guides to the Raspberry Pi — 
unsurprisingly, given the numbers 
of Pis sold, and the diversity of 
users — and they range from the 
basic to the mind-bogglingly 
comprehensive. This title is in the 
former camp, being somewhat 
concise, and is ina pleasingly small 
format — but nothing essential is 
missing from this work. 

After introducing the hardware, 
and booting up, we get a quick 
round-up of the command line. 
Each chapter finishes with a 


SHELL PROGRAMMING 
IN UNIX, LINUX AND OS X 


Author: Stephen G. Kochan, 


CU Enirizes 


‘Going Further’ section, and in 
this case, as well as some Linux 
references, the online Jargon File — 
which gives cultural background to 
several decades of ancestry behind 
Raspbian — is recommended. 
Thoughtful touches like this 
lift the book above many 
cobbled-together intros, as 
does the chapter selection, 
e.g. the brief round-up of 
interesting alternative OSes 
for the Pi, or the synergistic 
Pi/Arduino relationship. 
Python chapters are 
necessarily brief, but the GPIO 
section gives enough working 
examples to get the reader started, 
as does the chapter on Python and 
the internet, which introduces 
Flask. The section on cameras 
is also very useful. This is a very 
handy little book that will carry 
newbies a long way. 


Score 


to a subject that often causes 

confusion), cut and paste, 

sed, sort, and others. 
Scripting time, and 


& Patrick Wood 
Publisher: ie ee | the authors don't 
ie Gocice ” aie Peeing disappoint as commands 
ane , 
ISBN: 978-0134496009 ' and OS X MUX are introduced in a timely 


magpi.cc/2foCCOw 


More than a quarter 
of acentury after the 
first edition, this still-relevant 
classic gets a face-lift for today’s 
developers. Though they are 

likely to be using the shellona 
Mac or Linux box, rather than 

a Unix terminal, the book is 
applicable across all *nix-like 
environments. Kochan and Wood’s 
successful teaching-by-example 
Style is still present, but the 

book starts with a sensibly paced 
recap of basic commands, then 

the shell’s relationship to the 

rest of the system, before giving 
you some tools to work with: 
wildcards, regular expressions 

(in an exemplary fuss-free intro 


hy = 
if 
5 Fr 
% . 
“Fo sl 
we 


fashion, always with 
appropriate explanations of 
what’s happening as they’re 
executed. This continues as 
scripts build up, giving the reader 
an excellent understanding of 

how their operating system works 
behind the scenes. 

The sample phone book 
program gets revisited later with 
consideration for data formatting 
and other lessons learned, then 
— after nearly 300 pages of pure, 
POSIX compliant shell scripting — 
a look at the additions offered by 
Bash (Raspbian’s shell) and Korn 
(the basis for Zsh). 


Score 
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PYTHON 
DATA SCIENCE 
ESSENTIALS 


Alberto Boschete) te Mosseron 


Author: Luca Massaron & 
Alberto Boschetti 

Publisher: Packt 

Price: £27.99 

ISBN: 978-1786462138 

magpi.cc/2fOHVxc 


Python Data 
Science 


Essentials 


a Packt» 


Python is dominating the complex 
field of data science, its libraries 
and ease of use enabling scientists 
to combine work in “linear algebra, 
Statistical modelling, visualisation, 
computational linguistics, graph 
analysis, machine learning, 
business intelligence, and data 
storage and retrieval” to good 
effect. Prolific Python and data 
authors Massaron and Boschetti 
give us a work — expanded from the 
first edition — that should get any 
reasonably technical computer user 
started in understanding the field. 
The book assumes basic Python 
knowledge, but presents routes to 


INDUSTRY 4.0 


Author: Alasdair Gilchrist 
Publisher: Apress 

Price: £19.99 

ISBN: 978-1484220467 
magpi.cc/2foHu68 


In manufacturing, 
there is a synergy 
— that oft-abused 
word — of high-speed, low-cost 
communications and processing 
technologies with ever lower costs 
of storage and processing of data. 
Add in intelligent, self-monitoring 
sensors, and the ability to process 
and act upon mountains of data 

at real or near real-time speeds, 
and we’re approaching the “fourth 
industrial revolution” detailed 
here by Alasdair Gilchrist. 

This is a serious-minded look at 
the issue, somewhat dry at times, 
but very rewarding for anyone 
looking for a good round-up of 
the changes already observable 
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get you up to speed if necessary - 
the appendix on ‘Strengthening 
your Python Foundations’, with 
sections on code and places to 
learn (MOOCs, etc.). Each 
chapter, as well as teaching 
you the tools of data science 

— and Python’s great libraries 

— will build on Python basics 
to give you a practical mastery 
of the language which could be 
useful in other fields. 

From Jupyter Notebooks 
(formerly IPython), Numpy, 
Pandas, and Scikit-learn, through 
Theano and Tensorflow, to seaborn 
and ggplot visualisations, and web 
deployment with Bottle, the book 
retains its friendly walkthrough 
format throughout, including 
several practical examples. Data 
munging, machine learning 
algorithms, social network 
analysis, and more are all well 
covered, at an enjoyable pace. 


Score 


in industry, and the technologies 
driving them. Indeed, many 
makers — particularly those 
moving into manufacture of 
their projects — could find 
something useful here. 

After chapters on the 
industrial internet, and some of 
the network technologies driving 
the changes, the author moves 

up the stack to middleware then, 
after some of the interesting WAN 
technologies, software patterns and 
some of the security challenges. 

The value chain is next then, inter 
alia, the EU’s IoT6 workgroup’s 
promising results in replacing 
proprietary protocols, and use of 
augmented reality to prevent forklift 
truck accidents. After discussing 
POS changes, and smart factories, 
both present and future, there’s 

a roadmap to the future. 


Score 


ESSENTIAL READING: 


CHRISTMAS 


‘Tis the season of buying your loved ones 
useful and beautiful books to treasure. 


The Smart 

Solution Book 

Author: David Cotton 

Publisher: FT Publishing International 
Price: £16.99 

ISBN: 978-1292142319 
magpi.cc/2foKjUV 


Everybody's got problems, but Cotton has 
effective solutions to lift the gloom from a 
work-troubled colleague or relative. 


Edible Inventions 


Author: Kathy Ceceri 
Publisher: Maker Media, Inc 
Price: £14.50 

ISBN: 978-1680452099 
magpi.cc/2f0xs53 


Food meets inventiveness: hydraulic 
3D LEGO food printer, chemical cuisine, 
recipes, aquaponics, and a cardboard 
solar oven. Fun and inspirational. 


Games, Design 
and Play ° 


Author: Colleen Macklin & John Sharp 
Publisher: Addison Wesley 


GAMES, DESIGN PLAY 
siete erepece oom Game Otaeee 


Price: £30.99 ow: : ml: 
ISBN: 978-0134392073 oe xt 
magpi.cc/2foJ1t5 O$ o ae". 

i* . 


Games design as an art form - producing === 
games that people will love. Rules to take 
(and break) to any platform. 


ReMaking History, 
Volume 1 


Author: William Gurstelle 
Publisher: Maker Media, Inc 
Price: £14.50 

ISBN: 978-1680450606 
magpi.cc/2foLJyv 


Make: 
ReMaking History 


Early Makers 


A delightful and beautifully produced A 
look at ancient inventors and inventions, 
and how to recreate the latter at home. 


Scratch Programming 
Playground 


Author: Al Sweigart 
Publisher: No Starch 
Price: £17.99 

ISBN: 978-1593277628 
magpi.cc/2foGgMv 


SCRATCH 
PROGRAMMING 
PLAYGROUND 


Leas Ve PODERAe FT ED COTE 


From Breakout to Fruit Ninja, 
learning-as-fun for your 10- to 
12-year-old — or for you! 
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Community 


FEATURE 


SPY V. SPI 


ROBOT CODING MISSIONS 
CODE. CAPTURE. DEFEND 


Donning disguises, we arrange a rendezvous with Dexter Industries’ 
Taryn Sullivan to exchange information on a top-secret spy programme 


86 


EASIER 
ELECTRONICS 


The GrovePi (magpi.cc /2eEPX1V) is an add-on 
board that plugs into the Raspberry Pi's GPIO 
pins, and features numerous sockets to plug in 
Grove sensors and other electronic components, 
of which over 100 types are available. This makes 
it much easier to wire up physical computing 
projects, without the need for a breadboard. The 
Base Kit, as included with the Spy v. sPi, features 
an ultrasonic distance sensor, dial sensor, button, 
light sensor, buzzer alert, sound sensor, power 
relay, temperature/humidity sensor, LCD screen, 
and red, green, and blue LEDs. 


MagPi December 2016 


hhhh - you didn’t hear 
this irom us... Dexter 
Industries is launching a 
fun educational game that teaches 
children to solve problems in the 
form of secret spy missions. To 
prevent their own ‘jewel’ from 
being stolen by rivals in this 
capture-the-flag-style contest, 
teams will build protective 
programmable devices using 
components from the supplied 
robot kit, ranging from distance, 
sound, light, and infrared sensors, 
to buttoms, buzzers; and LEDs: 

“We got the idea from some of 
our customers with kids that loved 
playing spy games,” says Taryn 
Sullivan, COO at Dexter. “Then 
we met the guys from Building 
Momentum who develop and put 
on technical training of all kinds, 
and happen to know about the tech 
real spies use, and thought ‘that’s 
a perfect match!” 

While the Spy v. sPi project 
failed to hit the funding target in 


— its recent Kickstarter campaign 


(kck.st/2d5tyc6), Dexter confirms 
it’s definitely still going ahead. 
Missions come in the form of 

an illustrated colour booklet or 
CHUL MNES SUS SON SSO) NS AU Kes, 
including pictures, diagrams, extra 
resources, and videos. Each of the 
ten missions will teach players 
how to program the GrovePi board 
and an assortment of sensors to 


accomplish different objectives, 
all within a story created by 
‘real spies’. “Let’s just say they 
were all in the intelligence field, 
and have set up their fair share 
of surveillance tools for recon 
missions,” teases Taryn. 

She tells us that missions 
will have a real-life activity to 
accomplish, such as learning how 
to set a tripwire, or detecting when 
someone’s coming into your room. 
“Imagine you just hid your jewel 
in the perfect place and you want 
to ‘bug’ the door to the room, so 
you know when someone tries 
to enter. Spy v. sPi teaches you 
how to take the GrovePi and turn 
it into a real-life surveillance 
system. Using ultrasonic range 
finders and acoustic sensors, 
the sPis can invent unique and 
clandestine ways to monitor a 
door’s movement or detect a 
sneaking opponent.” 

In the team game, opponents 
will sneak around and try to 
physically capture the other side’s 
jewel’, while defending their own 
using the robot kit. Quite what 
the jewel is remains a mystery at 
this point: “[It] will be revealed 
by the spy as they accomplish 
their missions. We can’t give away 
too much!” 

While there are step-by-step 
instructions to help players build 
their kits and code the sensors, each 
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THE MONTH IN 


Everything else that happened this month in the world of Raspberry Pi 


The students of Fleetville Junior 
School in St Albans caught this 
candid photo of a muntjac deer 
with their Naturebytes camera. 
Since putting it up, they've caught 
foxes and squirrels milling about 


11-year-old Louis went above and beyond at Halloween and 
made this awesome light-up pumpkin using our tutorial from 
last issue. He especially liked how the LED had a candle 
flickering effect to it 
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ou folks out there are the reason we write 

the magazine, and we love it when you send 

us photos of stuff you’ve done using the 
magazine. Last month, we had two physical projects 
of note in the mag: our tiny cover robot and the 
light-up pumpkin using GPIO Zero code. People have 
already started making the robot, and one young 
reader made the pumpkin for Halloween himself! 
We also got a wonderful picture from a Naturebytes 
wildlife cam, which you can see on the left... 


Regular MagPi contributor and reader Richard Hayler made 
some modifications to our build files and 3D printed the 
chassis from last issue's robot. Check out our feature this 
issue on powering it up with sensors 


magpi@raspberrypi.org 
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CROWDFUND THIS! 


The best crowdfunding hits this month for you to check out... 


PRAELAWY 


PI EDITION 


PETITION MOJANG TO 
UPDATE MINECRAFT PI 


| magplice/20FyTpv 2eFyTpv 
R AS [2 I le - RY Dy 1 | 0 T Instead of money, this month we want to crowdsource 


S + | IF | [) [= A Vi | LY your opinion and votes! Minecraft Pi on the Raspberry 
Pi is excellent, but it could use an update and/or 
continual development. With that in mind, anew 
| Kekst/2evMys petition has been started on Change.org to try to 
Instead of being an all-in-one HAT, this is a modular convince Mojang, its developer, to resume work on 
family of different loT devices that youcan buildupon __ it. Give ita sign and maybe we can make it happen. 
your Pi or Pi Zero for diiferent functionality. GPRS, 3G, 
and 4G/LTE shields give you cellular internet access 
(with a SIM inserted) so you can use your Pi on the BE ST ‘e) THE RE Sih 
go. There are also GPS and XBee radio shields. The 
Kickstarter campaign has a while to run, so you should 
have plenty of time after reading this to decide on it. 
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RABBITMAX FLEX 


The RabbitMax Flex (excellent name) is an IoT HAT for 
the Raspberry Pi that doesn’t require any soldering. 
Not all HATs do require soldering, but it’s nice to know 
when one doesn’t in case you’re slightly anxious about 
picking up the iron. This board comes with a number 


a= A 
> . Rin 
Or ia 
;2* (m\.. 
of features, such as IR, a buzzer, a button, an RGB LED, , 


and slots for standard extra sensors. Check it out on 
its Indiegogo page. 
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mission has room for every spy to 
come up with their own unique way 
to complete it. In addition, there’s 
the option of playing alone: “Solo 
missions enable spies to go on their 
own missions, without needing an 
opponent. They will also learn to 
defend their room and use their spy 
device around their house.” 


Modular components 

To make things easier for 
newcomers, the hardware kit 
includes Dexter’s GrovePi board 
which enables the Raspberry Pi (not 
included) to be easily connected 

to Grove modular sensors, rather 


you can choose which one you’d 
like to use. “We found that while 
some people grow out of Scratch 

Hey Poicinovel, OTNeES sine Comins Sue 
complicated things with Scratch 
and don’t need to. Likewise, some 
prefer text-based languages like 
Python, so we wanted to offer that 
option too.” 

Making it accessible for everyone 
is a key aim for Dexter, which 
responded to some early feedback 
from testers: “At first they thought 
it was too hard, so we went back 
and revised the whole set of 
missions in a way that makes it 
really accessible for newbies, but 


SPY V. SPI 
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GOBOX ROBOTICS 
COURSE 


¢ 


Solo missions enable spies 
to go on thelr own missions, 
without needing an opponent 


than having to wire up standard 
electronic components. “The 
GrovePi makes it easy to get started 
with robotics because it has a board 
that sits on the Raspberry Pi, and 
comes with a collection of plug- 
and-play modules and sensors. 
While breadboarding can be fun, 
the GrovePi kit allows you to get to 
programming your device easier 
and faster.” 

When it comes to coding, 
missions are available in both 
Scratch and Python versions, so 
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kept the more advanced challenges 
in there for the experts.” 

The gaming aspect was alsoa 
major factor. “One of the reasons 
we decided to include a competitive 
aspect to this new programme is 
because we had so much interest 
from schools, camps, and after- 
school programs for GoBox,” 
says Taryn. “GoBox is more of an 
individual project based on the 
GoPiGo, a robot car. But we heard 
from educators that students are 
often encouraged by competition, 


so we thought this was a perfect 
narrative to allow for that kind 
OLAcwivilny: « 

While ten missions have been 
created so far, more may be added 
later. “We do envision offering 
more missions for spies to unlock 
as they advance, perhaps even 
using our new content platform, 
Dexter Studios, to be an avenue 
for spies to share missions with 
each other, or challenge spies to 
accomplish what they have come 
up with.” 
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COMMUNITY PROFILE 


When he’s not helping to expand the 
Raspberry Pi community, Alex is a keen 
macrophotographer and knife maker! 


_ lex purchased his first “T found that when I wanted to 
Raspberry Pi in May 2012 learn something new, generally 
after a BBC article caught the ‘instructions’ on other Linux 
his eye. Already teaching ICT at sites were either out of date or 
his son’s school, he was drawn incomplete. I wanted a place where 
to the idea of a $35 computer I could record procedures that | 
to aid the education of his could use again, but that would 
ten-year-old students. also be available to others.” 
That same month, Alex started Alex was determined to provide 
w Alexistruly his website, RasPi.TV, which tutorials that worked first time, 
Se ee ee llocc alti pe bhmrordoelinent understanding the frustration of 
Raspberry Pi community, 
providing supportand his progress with the Raspberry newcomers when their hard work 
eel es Boo ere Di amnditoeltate ameasy— tose didn’t always pay off. “It’s off- 
new to, and experienced 
in, the world of the Pi reference library for others. putting for people to follow a list 
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Explore 


Start a project About us KICK 
Created 
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RasPi0) 


GPIO Zero Ruler 


RasPiO GPIO Zero Code Reference 
Ruler for Raspberry Pi 


ALEX EAMES 


Community 


Sign up 


magpi.cc/2eF6uzO 


The ‘Kickstarter King’ has continued to bring his builds to the crownfunding network, 
building the RasPiO family in the process (magpi.cc/2eF7ML9) 


of instructions, get it all right, and 
then find the process fails,” he says. 
RasPi.TV was all about “instructions 
that work first time - even if you’ve 
never done it before.” 

In 2012, Alex began to build 
his own RasPiO boards, with 
the first releases making an 
appearance in March 2014. The 
GPIO labeller, Breakout, and 
Breakout Pro were successful 
across the community, earning 
an honourable mention on the 
official Raspberry Pi blog. The 


I wanted a place where I could 


‘family photo’ on his website 
(raspi.tv/rpifamily), showcasing 
every model built across the years. 
It’s a picture which often does the 
rounds of blogs, news articles, 
and social media. 

Outside of his life of Pi, Alex 
has a background in analytical 
chemistry, a profession that 
certainly explains his desire 
for the clean, precise, and well- 
tested tutorials that brought 
about the creation of RasPi.TV. 
From working as a translator to 


RasPi0 


July 2016 


rasp.io/introducing-raspio 


record procedures to use 


again, also available to others 


Pro has since been upgraded to 
the Pro HAT, while the labeller 
has been replaced with a newer 
40-pin version. The RasPiO 
collection has now increased 

to ten different units, each 
available for direct purchase from 
the website. A few originally 
found their feet via successful 
crowdfunding campaigns. 

Even if you’ve yet to visit either 
RasPi.TV or Alex’s YouTube channel, 
the chances are that you’ve seen 
one aspect of his online contribution 
to the Raspberry Pi Community. 
Alex maintains a Raspberry Pi 
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writing his own e-books, Alex 

is definitely well suited to the 
maker life, moving on from 

his past life of pharmaceutical 
development. His tutorial and 
review videos on YouTube reach 
viewing figures in the thousands, 
with his popular Raspberry Pi DSI 
Display Launch video garnering 
close to 300,000 views at the time 
of writing of this article. 

While Alex has updated us on 
his newest unreleased projects 
and plans, we’ll keep them quiet 
for now. You’1] have to watch the 
RasPi.TV website for details. 
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EVENT CALENDAR 


Find out what community-organised, Raspberry Pi- 
themed events are happening near you... 


Want a Raspberry Jam in your 
area? Want to start one? 
Email Ben Nuttall about it: 

ben@raspberrypi.org 


Sst Sie eg ee ate ls REGULAR EVENTS 


SITTINGBOURNE STAFFORD CAMJAM - CAMBRIDGE 

RASPBERRY JAM RASPBERRY JAM RASPBERRY JAM 

When: Saturday 10 December When: Tuesday 13 December When: Saturday 3 December 

Where: No. 34, Sittingbourne, UK Where: The Signpost Centre, Where: Institute of Astronomy, 

magpi.cc/2goInkRj Stafford, UK Cambridge, UK 

An interactive event that magpi.cc/2g0GT9x magpi.cc/2eF2a3k 

lets you get to grips with the A big meetup of Raspberry Pi The hometown event is back again 

Raspberry Pi and its software. enthusiasts to share ideas, help this December tOiscOumEteicar 
each other, and have fun. with one last Jam. 

RASPBERRY JAM EAGLE LABS RASPBERRY JAM 

HORSHAM RASPBERRY JAM #2 PRESTON 

When: Sunday 11 December When: Saturday 7 January When: Monday 5 December 

Where: Parkside, Horsham, UK Where: Serendip, Birmingham, UK Where: Media Innovation Studio, 

magpi.cc/2goLk45 magpi.cc/2go0LAjs Preston, UK 

Come and have fun exploring, There’ll be a range of things mMagpi.cc/2Z0EOE6 

learning, and using the (tOexplOne SUC as Pi pno/ecrs: Learn, create, and share the 

Raspberry Pi for coding, robotics, 3D printing, Minecraft coding, potential of the Raspberry Pi at a 


and more! family-friendly event. 


and electronics. 
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RASPBERRY JAM 
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> TORBAY 
TECH JAM 


RASPBERRY JAM LEEDS 
When: Wednesday 7 December 
Where: Swallow Hill Community 
Colleces Feeds yuk 
magpi.cc/2goKV15 
Everyone is invited for a couple 
of hours of computing fun, 
talks, demonstrations, and 
hands-on workshops. 


TORBAY TECH JAM 
When: Saturday 10 December 
Where: Paignton Library and 
Information Centre, 
Paignton, UK 
torbaytechjam.org.uk 
A fun, informal, and family-friendly 
event that aims to inspire people to get 
into code and take up STEM subjects. 
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FILL IN THE GAPS! 


IRELAND NEEDS RASPBERRY JAMS 


Another region that Ben Nuttall, 
Raspberry Jam community manager, 
has indicated is in need of Raspberry 
Jams is Ireland. There have been Jams 
in Dublin, along with a regular one in 
Belfast hosted by Andrew Mulholland. 
However, it would be great to get 
more of them through both Northern 
lreland and the Republic of Ireland. 
Check out our previous Jam interviews 
for tips on how to start a Jam, and try 
to bring a bit of computing education 
to your local community! 
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We're just going 
to sneakily plug 
our new range 
of Essentials 
books that are 
now in print 
here, including a 
Scratch book 


HAT onic PI 


ai 


LETTERS 


Three generations 
The Raspberry Pi computer has been a really great 
asset for me. 

Let me first give you my story. I’m no great 
computer whiz, although I have been around 
computers since the days of DOS (when I was 
knee-high). I've seen from Windows 3.1 all the way 
through to Windows 10, and I've played around with 
various Linux OSes, but I never really got involved 
with the coding side. I never knew coding. 

Now enter the Raspberry Pi. My first Pi was a 
Model 1 B, which ultimately became a Kodi box. 
When I upgraded to the B+, I gave the original 
Raspberry Pi to my brother who is still using it as a 
Kodi box. I gave the next to my Dad and showed him 
how to use it as a Kodi box too. Then I got two P1 3s, 
one of which I’m using as a Kodi box (do you see a 
trend?), and, after much trial and error, I've set the 
other up as a Samba media server. 

This is what taught me a lot about coding, and 
although my knowledge is far from complete, far 
from even scratching the surface, it’s given me the 
confidence to want to attempt my next project: 
an internet radio. One Pi I’ve set up as my son’s 
desktop, I introduced him to Scratch, and we 
haven’t seen him since... I think he’s still there 
playing around on it. 


So that is three generations of my family using it 
with confidence, with me planning on getting my 
sixth Pi. I cannot wait to see what the Raspberry Pi 
Foundation and Eben Upton bring us next (when is 
the Pi 4 coming out?). 

It’s a great little computer with loads of potential 
most of us never actually unlock. I’ve always read 
The MagPi and cannot wait for the next issue to 
be available. 
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Thank you to all those involved for just 
being awesome. 
Terence 


Thanks for your email, Terence. It’s great to hear how 
so many people in your family are using the Pi for 
something, even if it is just a bit of Kodi! If your son is 
really getting into Scratch, make sure to show him the 
Scratch Essentials book that we have out right now — it 
should help him learn a thing or two and keep him out 
of sight for a bit longer! 

As for the Raspberry Pi 4, you may have to wait a 
little while for that, but we’ll let Eben know you’re 
looking forward to it. 
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FROM THE FORUM: 


The Raspberry Pi Forum is a hotbed of 
conversations and problem-solving 
for the community - join in via 
raspberrypi.org/forums 


eader Ian Williams asks about the keyboard 
in the official starter kits - he wants to 
know whether English orders will contain 
a UK keyboard because the position of " and @ is 
reversed, which can cause problems when coding 
if using the US keyboard. This is Linux country... 
I assume changing the code from a keypress to 
another character is easy. There are plenty of 
instruction sites online. The editor of the page 
seems to only suggest rewiring the brain or buying a 


Pi CAN BE MESSY. 
BUT IT DOESN'T 
HAVE TO BE. 


O 0) 


cheap keyboard from elsewhere. Is the Pi somehow 
different, which makes key changes impossible? 
Ken 


Hi Ken. Ian was asking specifically about the 
physical layout of the keyboard, which is 
currently a US one. You’ re right, though: the 
input configuration can be changed to work like 

a UK keyboard in Raspbian. From the top-left 
menu, select Preferences, then Raspberry Pi 
Configuration. Click the Localisation tab, then Set 
Keyboard and you’ll be able to choose the layout. 


With a wide range of cables and 
enclosures for your Raspberry Pi 
projects and the WD PiDrive, WDLabs 
helps keep your creations properly 
powered and organized. 


wdlabs.wd.com/holiday 


© wDLABs 
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IQ ML TUBE OF 
ELECTRIC PAINT! 


y 7, si ,. 
“4, ’ vy >a '- /., Connecting the physical world to the digital world is easy with our fully featured 
ad J “4 4, vy » ey / & Ix, libraries and extensive online tutorials. You can also use Pi Cap with 
oO, iad "4 “s< & SV @ Mi Electric Paint: nontoxic, solvent free, and water soluble, you can use 


~ ¢ g “@ a O { £r9 ~ y 
f a>, 442, OF Og Of — this to paint wires or sensors directly onto almost any material. 


WHAT'S DIFFERENT 


ABOUT BARE 
CONDUCTIVES 
SPECIAL PAINT? 


OO — 


Tell us by Simply email 
for your chance to win! with your name, address, and answer! 


Terms & Conditions 

Competition closes on 19 December 2016. Prize is offered worldwide to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize 
supplier, their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from 
the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 


spam. Participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 
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Love your Pi? Love Music? 


Designed by audio experts, enjoyed by everyone 


Jaw dropping audio quality for your Raspberry Pi 
))) Connect Headphones, Speakers, RCA, Toslink, S/PDIF or XLR 
: We work with all the major music solutions to ensure compatibility 


Sonic Pi 
©) VoLuUMIO [OOCP) «Archphile 7 
‘ yer et | PiMusicBox 


Twitter: @IQ_audio lQaudio Limited, 
Email: info@iqaudio.com a U 'e C) Cricklade Wiltshire. 
Web: www.iqaudio.com Company No.: 9461908 


~ mindsensors.com 


Think @ Create @ Learn e Educate 


PiSTORMS-V2Z 


Make Stunning Robots with 
LEGOs and Raspberry Pi ! 
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Column | THE FINAL WORD 


MATT RICHARDSON 


Matt is Raspberry Pi's US-based product evangelist. Before 
that, he was co-author of Getting Started with Raspberry Pi 
anda contributing editor at Make: magazine. 


& HOLIDAYS 
” WITH PI 


‘For Matt Richardson, the holidays can be a time for digital 
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making with family 


hen I was a kid, it felt like it took forever 

for the holidays to arrive. Now that I’m an 
adult, the opposite is true. It feels like the 
holidays come hurtling at us faster and faster every 
year. As a kid, I was most interested in opening 
presents and eating all of that amazing holiday 
food. As an adult, I mostly enjoy the opportunity 

to put a pause on real life for a few days and spend 
time with my family. Though I do still love eating all 
that amazing holiday food! 

Invariably, the conversations with my extended 
family turn to Raspberry Pi at some point during the 
holidays. My relatives may have seen something in 
the news about it, or perhaps they have a friend who 
is creating their own retro gaming emulator with it, 
for example. I sometimes show off the Raspberry Pi 
projects that I’ve been working on and talk about 
what the Raspberry Pi Foundation is doing in order 
to put the power of digital making into the hands of 
people around the globe. 

All over the world there will be a lot of folks - both 
young and old — who may be receiving Raspberry Pis 
as gifts during the holidays. For them, hopefully it’s 
the start of a very rewarding journey making awesome 
stuff and learning about the power of computers. 

The side effect of so many people receiving 
Raspberry Pis as gifts is that around this time of year 
we get a lot of people asking, “So I have a Raspberry 
Pi... now whate” Of course, beyond using it as a typical 
computer, I encourage anyone with a Raspberry Pi 
to make something with it. There’s no better way to 
learn about computing than to create something. 

There’s no shortage of project inspiration out 
there. You’ ll find projects that you can make in this 
very issue of The MagPi, as well as all of the back 
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issues online, which are all available as free PDF files. 
We share the best projects we’ve seen on our blog, 
and our resources section contains fantastic how-to 
projects from our education team. 


Be inspired 

You can also explore sites such as Hackster. io, 
Instructables, Hackaday.io, and Makezine.com 

for tons of ideas for what you can make with your 
Raspberry Pi. Many projects include full step-by-step 
euides as well. Whatever you’re interested in — from 
music, gaming, electronics, natural sciences, to 
aviation — there’s sure to be something made with 
Raspberry Pi that’ll spark your interest. 

If you’re looking for something to make to 
celebrate the holiday season, you’re definitely 
covered. We have seen so many great holiday- 
related Raspberry Pi projects over the years, such as 
digital advent calendars, Christmas light displays, 
tree ornaments, digital menorahs, and New Year 
countdown clocks. And of course, not only does this 
issue of The MagPi contain a few holiday-themed Pi 
projects, you can even make something festive with 
the cover and a few LEDs. 

There’s a lot of stuff out there to make and | 
encourage you to work together with your family 
members on a project, even if it doesn’t seem to be 
their kind of thing. I think people are often surprised 
at how easy and fun it can be. And if you do make 
something together, please share some photos with us! 

Whatever you create and whatever holidays you 
celebrate, all of us at Raspberry Pi send you our very 
best wishes of the season and we look forward to 
another year ahead of learning, making, sharing, 
and having fun with computers. 
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CREATE YOUR OWN dia pued 
REMOTE CONTROLLED CAR os 


OR OBSTACLE-SENSING insiaalll ee 


FEATURES INCLUDE: 


© Light-weight aluminium 
e Electric motors 
¢ Large wheels 


© Stackable chassis plates 


www.robots.sb-components.co.uk Call: 0203 514 0914 


Oo Ata] At SB Components we strive to offer our customers the best prices 
for the best products. Our product team works tirelessly to source top 
Rates quality affordable components from around the world. 
[a] wae Raspberry Pi is a trademark of the Raspberry Pi Foundation. Raspberry Pi not included. 
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serial Pi Plus 


RS232 serial communication board. 
Control your Raspberry Pi over RS232 
or connect to external serial 
accessories. 


Breakout PF! Plus 


The Breakout Pi Plus is a useful 
and versatile prototyping expansion 
board for the Raspberry Pi 


ADC Ditferential P 


8 channel 18 bit analogue to digital 
converter. I*C address selection 
allows you to add up to 32 analogue 
inputs to your Raspberry Pi. 


IO Pi Plus 


32 digital 5V inputs or outputs. I?C 
address selection allows you to stack 
up to 4 1O Pi Plus boards on your 
Raspberry Pi giving you 128 digital 
inputs or outputs. 


RIC Pi Plus 


Real-time clock with battery backup 
and 5V I°C level converter for adding 
external 5V I?C devices to your 
Raspberry Pi. 


| Wire Pi Plus 


1-Wire® to I?C host interface with ESD 
protection diode and I*C address 
selection. 


electronics 


AISO 
available 
for the 
Pi Zero 


a / i O) 
GoPiGo 


Raspberry Pi + LEGO MINDSTORMS 


$99.99 USD-$199.99 USD 


